Linux Certif

Toute la documentation sur la certification Linux LPI

Hal::Cdroms.3pm

NAME

Hal::Cdroms - access cdroms through HAL and D-Bus

SYNOPSIS

   use Hal::Cdroms;
 
   my $hal_cdroms = Hal::Cdroms->new;
 
   foreach my $hal_path ($hal_cdroms->list) {
      my $m = $hal_cdroms->get_mount_point($hal_path);
      print "$hal_path ", $m ? "is mounted in $m" : "is not mounted", "\n";
   }
 
   my $hal_path = $hal_cdroms->wait_for_insert;
   my $m = $hal_cdroms->mount($hal_path);
   print "$hal_path is now mounted in $m\n";
 
 

DESCRIPTION

Access cdroms through HAL and D-Bus.

Hal::Cdroms->new

Creates the object

$hal_cdroms->list

$hal_cdroms->list

Returns the list of "hal_path" of the cdroms (mounted or not).

$hal_cdroms->get_mount_point($hal_path)

$hal_cdroms->get_mount_point($hal_path)

Return the mount point associated to the "hal_path", or undef it is not mounted.

$hal_cdroms->ensure_mounted($hal_path)

$hal_cdroms->ensure_mounted($hal_path)

Mount the "hal_path" if not already mounted. Return the mount point associated to the "hal_path", or undef it cannot be mounted successfully (see $hal_cdroms->{error}).

$hal_cdroms->mount_through_hal($hal_path)

$hal_cdroms->mount_through_hal($hal_path)

Mount the "hal_path" through HAL Return the mount point associated to the "hal_path", or undef it cannot be mounted successfully (see $hal_cdroms->{error}). If the cdrom is listed in fstab, HAL will refuse to mount it.

$hal_cdroms->mount($hal_path)

$hal_cdroms->mount($hal_path)

Mount the "hal_path" through HAL or fallback to plain mount(8). Return the mount point associated to the "hal_path", or undef it cannot be mounted successfully (see $hal_cdroms->{error})

$hal_cdroms->unmount($hal_path)

$hal_cdroms->unmount($hal_path)

Unmount the "hal_path". Return true on success (see $hal_cdroms->{error} on failure) If the cdrom is listed in not mounted by HAL, HAL will refuse to unmount it.

$hal_cdroms->unmount($hal_path)

$hal_cdroms->unmount($hal_path)

Unmount the "hal_path" through HAL or fallback on umount(8). Return true on success (see $hal_cdroms->{error} on failure)

$hal_cdroms->eject($hal_path)

$hal_cdroms->eject($hal_path)

Ejects the "hal_path". Return true on success (see $hal_cdroms->{error} on failure)

$hal_cdroms->wait_for_insert([$timeout])

$hal_cdroms->wait_for_insert([$timeout])

Waits until a cdrom is inserted. Returns the inserted "hal_path" on success. Otherwise returns undef.

You can give an optional timeout in milliseconds.

$hal_cdroms->wait_for_mounted([$timeout])

$hal_cdroms->wait_for_mounted([$timeout])

Waits until a cdrom is inserted and mounted by a volume manager (eg: gnome-volume-manager). Returns the mounted "hal_path" on success. Otherwise returns undef.

You can give an optional timeout in milliseconds.

AUTHOR

Pascal Rigaux <pixel@mandriva.com>