2.1.1. info namespace

The info namespace contain properties that can be considered metadata about device objects. These properties are always available.

2.1.2. linux namespace

This namespace is used to store Linux-specific metadata about the device object and is only available on Linux systems.

2.2.1. pci namespace

This namespace contains properties for device objects representing functions on devices on a PCI bus. These properties are available exactly when info.bus equals pci.

(FIXME: Some key PCI information (bus, slot, port, function etc.) is missing here)

2.2.2. serial namespace

Device objects that represent serial devices (e.g. /dev/ttyS* or /dev/ttyUSB*).

2.2.3. usb_device namespace

For device objects representing USB devices the property info.bus will be usb_device, and the following properties will be available. Note that the corresponding USB interfaces are represented by separate device objects as children.

2.2.4. usb namespace

Device objects that represent USB interfaces, ie. when info.bus assumes usb, are represented by the properties below. In addition all the usb_device.* properties from the parent USB device is available in this namespace but only with the usb prefix instead of usb_device.

2.2.5. platform namespace

Devices that are built into the platform or present on busses that cannot be properly enumerated (e.g. ISA) are represented by device objects where info.bus equals platform. These kind of devices are commonly, somewhat incorrectly, called legacy devices.

2.2.6. ide_host namespace

The ide_host namespace is present for device objects where info.bus is set to ide_host. Such device objects represent IDE and ATA host adaptors for harddisks and optical drives as found in the majority of computer systems.

2.2.7. ide namespace

ATA and IDE drives are represented by device objects where info.bus equals ide. The following properties are available for such device objects.

2.2.8. scsi_host namespace

The scsi_host namespace is present for device objects where info.bus is set to scsi_host. Such device objects represent SCSI host adaptors for SCSI devices as found in some computer systems.

2.2.9. scsi namespace

SCSI devices are represented by device objects where info.bus equals scsi. The following properties are available for such device objects.

2.2.10. ieee1394_host namespace

Device objects with info.bus set to ieee1394_host represent IEEE 1394 host adaptors. The following properties are available for such device objects.

2.2.11. ieee1394_node namespace

Device objects with info.bus set to ieee1394_node represent IEEE 1394 nodes on a IEEE 1394 bus. The following properties are available for such device objects.

2.2.12. ieee1394 namespace

Device objects with info.bus set to ieee1394 represent IEEE 1394 devices. The following properties are available for such device objects.

2.2.13. mmc_host namespace

Device objects with info.bus set to mmc_host represent MultiMediaCard or Secure Digital host adaptors. The following properties are available for such device objects.

2.2.14. mmc namespace

Device objects with info.bus set to mmc represent MultiMediaCard or Secure Digital cards. The following properties are available for such device objects.

2.2.15. ccw namespace

Device objects that represent s390 ccw devices (when info.bus is set to ccw) are represented by the properties below.

The following properties describe ccw devices where linux.driver is either dasd-eckd or dasd-fba.

The following properties describe ccw devices where linux.driver is zfcp. They are only present when ccw.online = 1.

The following properties describe ccw devices where linux.driver is of the form tape_3xxx .

The following properties describe ccw devices where linux.driver is 3270.

2.2.16. ccwgroup namespace

Device objects that represent groups of ccw devices (when info.bus is set to ccwgroup have the properties specified below.

The following properties describe ccwgroup devices where linux.driver is qeth.

The following properties describe ccwgroup devices where linux.driver is ctc.

The following properties describe ccwgroup devices where linux.driver is lcs.

The following properties describe ccwgroup devices where linux.driver is claw.

2.2.17. iucv namespace

Device objects with info.bus set to iucv are using the "Intra-User Comminication Vehicle" and are described by the following properties.

The following properties describe iucv devices where linux.driver is netiucv.

2.2.18. block namespace

Device objects representing addressable block devices, such as drives and partitions, will have info.bus set to block and will export a number of properties in the block namespace.

2.2.19. xen namespace

Device objects representing virtual devices under the Xen Virtual Machine Monitor, such as frontend network or block devices, will have info.bus set to block and will export a number of properties in then xen namespace.

2.3.1. volume namespace

This namespace is for device objects that represent storage devices with a filesystem that can be mounted. Such device objects will have the capability volume and they will export the properties below. Note that device objects can only have the volume capability if they already have the capability block and the property block.is_volume set to TRUE.

Device objects with this capability may emit the following device conditions

2.3.2. system namespace

This namespace is found on the toplevel "Computer" device, and represents information about the system and the currently running kernel.

2.3.3. volume.disc namespace

This namespace is for device objects that represent optical discs, e.g. device objects with the capability volume.disc. Such device objects will also have the capability volume.

2.3.4. storage namespace

This namespace is used to describe physical storage devices and their capabilities. Such device objects will have the capability storage and they will export the properties below. Note that device objects can only have the storage capability if they already got capability block and the property block.is_volume set to FALSE. One significant between the storage and block namespace is that the properties exported in the storage represents constant vital product information, whereas the properties in the block namespace represent variable system-dependent information.

2.3.5. storage.cdrom namespace

This namespace is used to describe optical storage drives and their capabilities.Such device objects will have the capability storage.cdrom and they will export the properties below. Note that device objects can only have the storage.cdrom capability if they already got the capability storage.

2.3.6. net namespace

This namespace is used to describe networking devices and their capabilities.Such device objects will have the capability net and they will export the properties below. This namespace only describe the generic aspect of networking devices; specific networking technologies such as IEEE 802.3 and IEEE 802.11 have separate namespaces.

2.3.7. net.80203 namespace

Ethernet networking devices is described in this namespace for device objects with the capability net.80203. Note that device objects can only have the net.80203 capability if they already have the capability net.

2.3.8. net.80211 namespace

Wireless ethernet networking devices is described in this namespace for device objects with the capability net.80211. Note that device objects can only have the net.80211 capability if they already have the capability net.

2.3.9. net.irda namespace

IrDA (Infrared Data Association) Networking devices are described in this namespace for device objects with the capability net.irda. Note that device objects can only have the net.irda capability if they already have the capability net.

2.3.10. net.80211control namespace

Control devices for Wireless ethernet networking devices are described in this namespace for device objects with the capability net.80211control. Note that device objects can only have the net.80211control capability if they already have the capability net. Warning: You should know what you do if you touch this devices. They are not always stable and can cause (kernel) crashes (on linux).

2.3.11. input namespace

This namespace is concerned with human input devices such as keyboards, mice, pointing devices and game controllers. If a device object has the capability input then the following properties are available

2.3.12. pcmcia_socket namespace

Device objects with the capability pcmcia_socket represent bridge devices (the actual bus of the device may differ) that PCMCIA cards can be attached to. The following properties are available.

2.3.13. printer namespace

Device objects with the capability printer represent printers. The following properties are available.

2.3.14. portable_audio_player namespace

Device objects with the capability portable_audio_player represent portable audio players that can be attached to a computer to exchange files. They can also playback audio. Sometimes they can also record audio. This capability can't, in general, be reliably probed from the hardware so the information needs to be merged from either device information files or callouts. Therefore this capability should be merged on the appropriate device object that represents the addressable piece of hardware that is the portable music player; for USB devices this would be the device object representing the appropriate USB interface. The following properties are available:

2.3.15. alsa namespace

Device objects with the capability alsa represent all the streams available through ALSA on a soundcard.

2.3.16. oss namespace

Device objects with the capability oss represent all the streams available through OSS on a soundcard. OSS devices could be emulated by ALSA.

Note: All OSS devices, except the global devices, are only added if the kernel supports links from oss device to physical device in sysfs. For a patch see: http://thread.gmane.org/gmane.comp.freedesktop.hal/2862.

2.3.17. camera namespace

Device objects with the capability camera represent digital still cameras that can be attached to a computer to exchange files. This does not include card readers for memory cards used for cameras. This capability can't, in general, be reliably probed from the hardware so the information needs to be merged from either device information files or callouts. Therefore this capability should be merged on the appropriate device object that represents the addressable piece of hardware that is the digital still camera; for USB devices this would be the device object representing the appropriate USB interface. The following properties are available:

2.3.18. laptop_panel namespace

Device objects with the capability laptop_panel represent devices capable of changing the brightness of the display.

The following methods exist on the interface org.freedesktop.Hal.Device.LaptopPanel.

2.3.19. video_adapter_pm namespace

Device objects with the capability video_adapter_pm represent video adapters that need to be suspended or resumed in device specific ways.

The following methods exist on the interface org.freedesktop.Hal.Device.VideoAdapterPM.

2.3.20. ac_adaptor namespace

Device objects with the capability ac_adaptor represent all the devices capable of powering the system from AC power

2.3.21. battery namespace

Device objects with the capability battery represent all the devices having some battery (in many cases - rechargeable) inside.

2.3.22. button namespace

Device objects with the capability button represent the devices capable of providing a state to the system.

Device objects with this capability may emit the following events.

2.3.23. processor namespace

Device objects with the capability processor represent CPU's in the system.

2.3.24. display_device namespace

Device objects with the capability display_device represent display devices attached to the system.

2.3.25. sensor namespace

Device objects with the capability sensor represent light or temperature sensors in the system.

2.3.26. power_management namespace

Keys with the prefix power_management provide information about power management supported by your computer.

The following methods exist on the interface org.freedesktop.Hal.Device.SystemPowerManagement.

The following methods exist on the interface org.freedesktop.Hal.Device.CPUFreq.

The following errors maybe raised on the interface org.freedesktop.Hal.Device.CPUFreq.

2.3.27. tape namespace

Device objects with the capability tape represent tape devices.

2.4.1. storage.policy.default namespace

This namespace specifies the default policy for storage devices - these properties should be merged on the root computer device object.

2.4.2. storage.policy namespace

This namespace contains properties that can be merged on individual storage devices to specify how and if the storage device should be mounted.

2.4.3. volume.policy namespace

This namespace contains properties that can be merged on individual volumes to specify how and if the volume should be mounted.

3.1.1. Example: MP3 player

        <?xml version="1.0" encoding="UTF-8"?>

<!-- Example: This device information file matches an USB Mass Storage based MP3 player 
              by the matching on the USB vendor and product identifiers. -->

<deviceinfo version="0.2">
  <device>
    <match key="info.bus" string="usb">
      <match key="usb.vendor_id" int="0x066f">
        <match key="usb.product_id" int="0x8000">
          <merge key="info.category" type="string">portable_audio_player</merge>
          <merge key="info.capabilities" type="string">portable_audio_player</merge>
          <merge key="portable_audio_player.access_method" type="string">storage</merge>
          <merge key="portable_audio_player.output_formats" type="string">audio/mpeg audio/x-ms-wma</merge>
          <merge key="portable_audio_player.input_formats" type="string">audio/x-wav</merge>
        </match>
      </match>
    </match>
  </device>
</deviceinfo>
      

The final set of properties look like this:

3.1.2. Example: Digital Still Camera

        <?xml version="1.0" encoding="UTF-8"?>

<!-- Example: This device information file matches a Sony digital still 
              camera by matching on the USB vendor and product identifers.  -->

<deviceinfo version="0.2">
  <device>
    <match key="info.bus" string="usb">
      <match key="usb.vendor_id" int="0x054c">
        <match key="usb.product_id" int="0x0010">
          <merge key="info.category" type="string">camera</merge>
          <merge key="info.capabilities" type="string">camera</merge>
          <merge key="camera.access_method" type="string">storage</merge>
        </match>
      </match>
    </match>
  </device>
</deviceinfo>
      

The final set of properties look like this:

3.1.3. Example: Card Reader

        <?xml version="1.0" encoding="UTF-8"?>

<!-- Example: This device information file matches a memory card reader with 
              multiple storage ports that can be active at the same time. -->

<deviceinfo version="0.2">
  <device>
    <match key="storage.bus" string="usb">
      <match key="@storage.physical_device:usb.vendor_id" int="0x0424">
        <match key="@storage.physical_device:usb.product_id" int="0x20fc">
          <match key="storage.lun" int="0">
            <merge key="storage.drive_type" type="string">compact_flash</merge>
	  </match>
          <match key="storage.lun" int="1">
            <merge key="storage.drive_type" type="string">memory_stick</merge>
	  </match>
          <match key="storage.lun" int="2">
            <merge key="storage.drive_type" type="string">smart_media</merge>
	  </match>
          <match key="storage.lun" int="3">
            <merge key="storage.drive_type" type="string">sd_mmc</merge>
	  </match>
        </match>
      </match>
    </match>
  </device>
</deviceinfo>
      

As described in the documentation for the storage.physical_device property in Section 2.3.4 this device information file export information about each storage port through the property storage.drive_type. Thus, one of the four storage devices has the following properties that are merged from the device object that the device information file targets:

3.2.1. Storage Devices

Policy for storage devices is expressed in the storage.policy.default, storage.policy and volume.policy namespaces, see Section 2.4 for details.

        <?xml version="1.0" encoding="UTF-8"?>

<deviceinfo version="0.2">

  <!-- Example: Match volumes from an external USB harddisk enclosure by 
                matching on vendor and model. Use mount points 

  		    my_usbdisk_part_<partition-number>

		NB: some drives (ieee1394 based IIRC) even export the
		property storage.serial, the unique serial number of the
		disk which is a better match -->
  <device>
    <match key="block.is_volume" bool="true">
      <match key="volume.fsusage" string="filesystem">
	<match key="@block.storage_device:storage.vendor" string="ST360021">
	  <match key="@block.storage_device:storage.model" string="A">
	    <merge key="volume.policy.desired_mount_point" type="string">my_usbdisk_partition_</merge>
	    <append key="volume.policy.desired_mount_point" type="copy_property">volume.partition.number</append>
	  </match>
	</match>
      </match>
    </match>
  </device>

  <!-- Example: Match a volume from an USB Storage Based mp3 player
                by the file system UUID and assign a mount point.

                NB: When reformatting the volume a new UUID will be
                used and this rule will have to be altered -->
  <device>
    <match key="block.is_volume" bool="true">
      <match key="volume.fsusage" string="filesystem">
	<match key="volume.uuid" string="4150-3F34">
	  <merge key="volume.policy.desired_mount_point" type="string">my_mp3_player</merge>
	</match>
      </match>
    </match>
  </device>

</deviceinfo>
      

4.2.1. Interface org.freedesktop.Hal.Manager

Using D-BUS terminology, the HAL daemon provides the D-BUS service org.freedesktop.Hal. This service offers a D-BUS object at a well-known location /org/freedesktop/Hal/Manager. This object offers a D-BUS interface, org.freedesktop.Hal.Manager, for querying device objects with the following methods:

# Return a list of all devices in the GDL
#
# @return                       List of UDI's
#
array{string} GetAllDevices()
# Determine if a device with a given Unique Device Id exists in the GDL
#
# @param  udi                   Device UDI, for example '/org/freedesktop/Hal/devices/pci_8086_7111'
# @return                       TRUE iff the device with the given UDI exists
#
bool DeviceExists(string udi)
# Find the set of devices in the GDL that has a given property matching
# a given value
#
# @param  key                   Key, for example 'block.fstype'
# @param  value                 Value, for example 'ext3'
# @return                       Array of UDI's, may be empty
#
array{string} FindDeviceStringMatch(string key, string value)
# Find the set of devices in the GDL that has a given capability
#
# @param  capability            Capability, for example 'volume'
# @return                       Array of UDI's, may be empty
#
array{string} FindDeviceByCapability(string capability)
      

This object also emits the following signals on the /org/freedesktop/Hal/Manager object on the org.freedesktop.Hal.Manager interface that applications can subscribe to using D-BUS:

# Notification that a new device have been added to the GDL
#
# @param  udi                   Unique Device Id
#
void DeviceAdded(string udi)
# Notification that a new device have been removed from the GDL. The
# application cannot use this UDI anymore.
#
# @param  udi                   Unique Device Id
#
void DeviceRemoved(string udi)
# Notification that a device in the GDL have got a new capability. Note that
# this is emitted even though the device already had the old capability
#
# @param  udi                   Unique Device Id
#
void NewCapability(string udi, string capability)
      

          #!/usr/bin/python
 
import gtk
import dbus

def device_added(interface, signal_name, service, path, message):
    [udi] = message.get_args_list ()
    print 'Device %s was added'%udi

def device_removed(interface, signal_name, service, path, message):
    [udi] = message.get_args_list ()
    print 'Device %s was removed'%udi

 
bus = dbus.Bus (dbus.Bus.TYPE_SYSTEM)
hal_service = bus.get_service ('org.freedesktop.Hal')
hal_manager = hal_service.get_object ('/org/freedesktop/Hal/Manager',
				      'org.freedesktop.Hal.Manager')

devices = hal_manager.GetAllDevices ()
for d in devices:
    print 'Found device %s'%d

bus.add_signal_receiver (device_added,
			 'DeviceAdded',
			 'org.freedesktop.Hal.Manager',
			 'org.freedesktop.Hal',
			 '/org/freedesktop/Hal/Manager')
bus.add_signal_receiver (device_removed,
			 'DeviceRemoved',
			 'org.freedesktop.Hal.Manager',
			 'org.freedesktop.Hal',
			 '/org/freedesktop/Hal/Manager')
gtk.main()
        

Found device /org/freedesktop/Hal/devices/block_TORiSAN DVD-ROM DRD-U624-00000000000000000001-disc
Found device /org/freedesktop/Hal/devices/block_TORiSAN DVD-ROM DRD-U624-00000000000000000001
Found device /org/freedesktop/Hal/devices/block_37332a77-105e-4e76-8e99-27d3746e0531
Found device /org/freedesktop/Hal/devices/block_3_2
Found device /org/freedesktop/Hal/devices/block_LS-120 SLIM3 00 UHD Floppy-0208MBA00211
Found device /org/freedesktop/Hal/devices/block_IC25N020ATCS05-0-CLP225F2G3UR4A
Found device /org/freedesktop/Hal/devices/ide_1_1
Found device /org/freedesktop/Hal/devices/ide_0_0
Found device /org/freedesktop/Hal/devices/ide_1_0
Found device /org/freedesktop/Hal/devices/usbif_usb_0_0_206_-1_0000:00:07.2_0
Found device /org/freedesktop/Hal/devices/ide_host_0
Found device /org/freedesktop/Hal/devices/ide_host_1
Found device /org/freedesktop/Hal/devices/pci_104c_8400
Found device /org/freedesktop/Hal/devices/usb_0_0_206_-1_0000:00:07.2
Found device /org/freedesktop/Hal/devices/pci_1002_4c4d
Found device /org/freedesktop/Hal/devices/pci_125d_1978
Found device /org/freedesktop/Hal/devices/pci_8086_7111
Found device /org/freedesktop/Hal/devices/pci_104c_ac1c/0
Found device /org/freedesktop/Hal/devices/pci_8086_7112
Found device /org/freedesktop/Hal/devices/pci_8086_7110
Found device /org/freedesktop/Hal/devices/input_13_65
Found device /org/freedesktop/Hal/devices/pci_104c_ac1c
Found device /org/freedesktop/Hal/devices/pci_8086_7190
Found device /org/freedesktop/Hal/devices/input_13_64
Found device /org/freedesktop/Hal/devices/pci_8086_7113
Found device /org/freedesktop/Hal/devices/pci_8086_7191
Found device /org/freedesktop/Hal/devices/computer
(insert USB mouse)
Device /org/freedesktop/Hal/devices/usb_46d_c001_410_-1_noserial was added
Device /org/freedesktop/Hal/devices/usbif_usb_46d_c001_410_-1_noserial_0 was added
(remove USB mouse)
Device /org/freedesktop/Hal/devices/usb_46d_c001_410_-1_noserial was removed
Device /org/freedesktop/Hal/devices/usbif_usb_46d_c001_410_-1_noserial_0 was removed
        

4.2.2. Interface org.freedesktop.Hal.Device

Applications use the org.freedesktop.Hal.Manager interface to locate the device objects they are interested in. When a device object (which is really a D-BUS object, note that the UDI is the objects object_path) is obtained, the HAL daemon provides the org.freedesktop.Hal.Device interface on the object denoted by the UDI. This interface has the following methods

# Set property
#
# @param  key                   Property to set
# @param  value                 Value to set
# @raises                       org.freedesktop.Hal.(NoSuchDevice|TypeMismatch|PermissionDenied)
#
void SetProperty(string key, any value)
void SetPropertyString(string key, string value)
void SetPropertyInteger(string key, int32 value)
void SetPropertyBoolean(string key, bool value)
void SetPropertyDouble(string key, double value)
# Get property
#
# @param  key                   Property to get
# @return                       The value of the property
# @raises                       org.freedesktop.Hal.(NoSuchDevice|NoSuchProperty|TypeMismatch)
#
any GetProperty(string key)
string GetPropertyString(string key)
int32 GetPropertyInteger(string key)
bool GetPropertyBoolean(string key)
double GetPropertyDouble(string key)
# Get all properties
#
# @return                       Dictionary from key to value
# @raises                       org.freedesktop.Hal.NoSuchDevice
#
map{string, any} GetAllProperties()
# Remove a property
#
# @param  key                   Property to remove
# @raises                       org.freedesktop.Hal.(NoSuchDevice|NoSuchProperty|PermissionDenied)
#
void RemoveProperty(string key)
# Get the type of a property
#
# @param  key                   Property
# @return                       D-BUS type of property
# @raises                       org.freedesktop.Hal.(NoSuchDevice|NoSuchProperty)
#
int32 GetPropertyType(string key)
# Determine if a property exists
#
# @param  key                   Property
# @return                       TRUE iff the property exists
# @raises                       org.freedesktop.Hal.NoSuchDevice
#
bool PropertyExists(string key)
# Add a capability to a device. Note that this will trigger a NewCapability
# signal to all client applications subscribing to signals from the Manager
# interface.
#
# @param  capability            Capability, e.g. 'net.80211'
# @raises                       org.freedesktop.Hal.(NoSuchDevice|PermissionDenied)
#
void AddCapability(string capability)
# Determine if a device got a given capability
#
# @param  capability            Capability, e.g. 'storage.cdrom'
# @return                       TRUE iff the device got the given capability
# @raises                       org.freedesktop.Hal.NoSuchDevice
#
bool QueryCapability(string capability)
# Take an advisory lock on the device.
#
# @param  reason                A user-presentable reason why the device
#                               is locked.
# @raises                       org.freedesktop.Hal.NoSuchDevice,
#                               org.freedesktop.Hal.DeviceAlreadyLocked
#
void Lock(string reason)
# Release an advisory lock on the device.
#
# @raises                       org.freedesktop.Hal.NoSuchDevice,
#                               org.freedesktop.Hal.DeviceAlreadyLocked,
#                               org.freedesktop.Hal.PermissionDenied
#
void Unlock()
      

The device objects also emits the following signals on the org.freedesktop.Hal interface that applications can subscribe to using D-BUS

# Notification that property have been modified
#
# @param  key                   Property
# @param  added                 True iff the property have been added
# @param  removed               True iff the property have been removed
#
void PropertyModified(string key, bool added, bool removed)
# Notification that an event happened on the device has occured.
#
# Normally this is used to signal events that aren't or can't be expressed
# in properties, e.g. 'ProcessorOverheating' etc.
#
# @param  condition             Name of condition
# @param  ...                   Dependent on the condition name
void Condition(string condition, ...)
      

Note that D-BUS supports that applications can opt to receive signals for only a subset of the devices available.

4.2.3. Interface org.freedesktop.Hal.Device.Volume

The org.freedesktop.Hal.Device.Volume interface is used on objects with the "volume" capability. This interface has the following methods.

# Mount volume
#
# @param  mountpoint            Desired mount point. If NULL, will be generated based on label.
# @param  fstype                Filesystem type
# @param  options               Mount options
# @raises                       org.freedesktop.Hal.Device.Volume.NoSuchDevice
#                               org.freedesktop.Hal.Device.Volume.PermissionDenied
#                               org.freedesktop.Hal.Device.Volume.AlreadyMounted
#                               org.freedesktop.Hal.Device.Volume.InvalidMountOption
#                               org.freedesktop.Hal.Device.Volume.UnknownFilesystemType
#                               org.freedesktop.Hal.Device.Volume.InvalidMountpoint
#                               org.freedesktop.Hal.Device.Volume.MountPointNotAvailable
#                               org.freedesktop.Hal.Device.Volume.PermissionDeniedByPolicy
#
void Mount(string mountpoint, string fstype, array{string} options)
# Unmount volume
#
# @param  options               Unmount options
# @raises                       org.freedesktop.Hal.Device.Volume.NoSuchDevice
#                               org.freedesktop.Hal.Device.Volume.PermissionDenied
#                               org.freedesktop.Hal.Device.Volume.InvalidUnmountOption
#                               org.freedesktop.Hal.Device.Volume.InvalidMountpoint
#                               org.freedesktop.Hal.Device.Volume.MountPointNotAvailable
#                               org.freedesktop.Hal.Device.Volume.PermissionDeniedByPolicy
#
void Unmount(array{string} options)
# Eject volume
#
# @param  ejectoptions          Eject options
# @raises                       org.freedesktop.Hal.Device.Volume.NoSuchDevice
#                               org.freedesktop.Hal.Device.Volume.PermissionDenied
#                               org.freedesktop.Hal.Device.Volume.InvalidEjectOption
#                               org.freedesktop.Hal.Device.Volume.PermissionDeniedByPolicy
#
void Eject(array{string} options)
      

4.2.4. Interface org.freedesktop.Hal.Device.Storage

The org.freedesktop.Hal.Device.Storage interface is used on objects with the "storage" capability. This interface has the following methods.

# Eject media
#
# @param  ejectoptions          Eject options
# @raises                       org.freedesktop.Hal.Device.Storage.NoSuchDevice
#                               org.freedesktop.Hal.Device.Storage.PermissionDenied
#                               org.freedesktop.Hal.Device.Storage.InvalidEjectOption
#                               org.freedesktop.Hal.Device.Storage.PermissionDeniedByPolicy
#
void Eject(array{string} options)
# Close media tray
#
# @param  closetrayoptions      Close tray options
# @raises                       org.freedesktop.Hal.Device.Storage.NoSuchDevice
#                               org.freedesktop.Hal.Device.Storage.PermissionDenied
#                               org.freedesktop.Hal.Device.Storage.InvalidCloseTrayOption
#                               org.freedesktop.Hal.Device.Storage.PermissionDeniedByPolicy
#
void CloseTray(array{string} options)
      

4.3.1. Storage Devices