#ident "@(#)interfaces.txt	1.7	06/08/11 SMI"

Interface                           Stability    Comments
============================================================================

New and changed interfaces:

Note: Primary HAL API is defined in terms of D-BUS architecture.
API includes Properties associated with device objects and
D-BUS Interfaces exported by the HAL daemon. Each HAL interface
has associated Methods and emitted Signals. Stability will remain
Volatile until HAL reaches 1.0 (current revision is 0.5.8).

HAL API                             Volatile     See hal-spec.html
  Device properties                 Volatile     hal-spec.html, chapter 2
  org.freedesktop.Hal.Manager       Volatile     hal-spec.html, section 4.2.1
    GetAllDevices()
    DeviceExists()
    FindDeviceStringMatch()
    FindDeviceByCapability()
    DeviceAdded()
    DeviceRemoved()
    NewCapability()
  org.freedesktop.Hal.Device        Volatile     hal-spec.html, section 4.2.2
    GetAllProperties()
    {Get,Set}Property{String,Integer,Boolean,Double}()
    RemoveProperty()
    GetPropertyType()
    PropertyExists()
    AddCapability()
    QueryCapability()
    Lock()/Unlock()
    ClaimBranch()/UnclaimBranch()
    PropertyModified()
    Condition()
  org.freedesktop.Hal.Device.Volume Volatile     hal-spec.html, section 4.2.3
    Mount()/Unmount()
    Eject()
    ZpoolExport(), ZpoolImport()

Note: Since HAL API is a D-BUS API, any D-BUS language binding (C, glib, Java,
Python) can be used by applications. LSARC/2006/368 D-BUS Message Bus System
defined C bindings (libdbus-1) and glib bindings (libdbus-glib-1) as Volatile.
In addition, there are two HAL-specific convenience libraries on top of
libdbus-1: libhal and libhal-storage, delivered by this project. These are
the interfaces used by most GNOME HAL-based applications:

libhal                              Volatile     See libhal.h
libhal-storage                      Volatile     See libhal-storage.h

fdi(4) file format                  Volatile     See fdi.4.txt man page
libpolkit                           Volatile     See polkit.h

Note: RBAC authorizations are used as a backend for libpolkit to control
access to privileged operations, Currently the only operations supported
are mounting of filesystems on different types of storage. Safe mount options
enforce noexec,nosuid. "Basic Solaris User" profile will include
'solaris.device.mount.removable' by default.

solaris.device.mount.removable      Volatile     allow mount removable media
                                                     with safe mount options
solaris.device.mount.alloptions.removable Volatile  allow mount removable media
                                                        with any mount options
solaris.device.mount.fixed          Volatile     allow mount fixed storage
                                                   with safe mount options
solaris.device.mount.alloptions.fixed Volatile   allow mount fixed storage
                                                    with any mount options

lshal(1M)                           Volatile     See lshal.1m.txt
hal-device(1M)                      Volatile     See hal-device.1m.txt
hal-find-by-capability(1M)          Volatile     See hal-find.1m.txt
hal-find-by-property(1M)            Volatile     See hal-find.1m.txt
hal-get-property(1M)                Volatile     See hal-get-property.1m.txt
hal-set-property(1M)                Volatile     See hal-get-property.1m.txt
hal-fdi-validate(1M)                Volatile     See hal-fdi-validate.1m.txt
hal(1M)                             Volatile     See hal.1m.txt
polkit-is-privileged(1M)            Volatile     See polkit-is-privileged.1m.txt

/usr/lib/hal                        Volatile     HAL binaries
/etc/hal/fdi                        Volatile     HAL fdi files

/usr/share/hwdata/pci.ids           Volatile     opensource PCI device database
					http://pciids.sourceforge.net/pci.ids
/usr/share/hwdata/usb.ids           Volatile     opensource USB device database
					http://www.linux-usb.org/usb.ids

svc:/system/hal                     Uncommitted  HAL SMF service
solaris.smf.manage.hal              Uncommitted  authorization to manage service
                                                          (action_authorization)
solaris.smf.modify.hal              Uncommitted  authorization to modify service
                                                          (modify_authorization)
solaris.smf.value.hal               Uncommitted  authorization to change values
                                                          (value_authorization)
HAL Management                      Uncommitted  HAL SMF rights profile

svc:/system/filesystem/rmvolmgr     Uncommitted  rmvolmgr SMF service
solaris.smf.manage.rmvolmgr         Uncommitted  authorization to manage service
solaris.smf.modify.rmvolmgr         Uncommitted  authorization to modify service
solaris.smf.value.rmvolmgr          Uncommitted  authorization to change values
Rmvolmgr Management                 Uncommitted  rmvolmgr SMF rights profile

rmmount(1)                          Uncommitted  See rmmount.1.txt
rmumount(1)                         Uncommitted  See rmmount.1.txt
volcheck(1)                         Uncommitted
eject(1)                            Uncommitted  See eject.1.txt

EC_TTY                              ConsPrivate  See proposal.txt
ESC_DEVPERM_LOGIN                   ConsPrivate  See proposal.txt
ESC_DEVPERM_LOGOUT                  ConsPrivate  See proposal.txt
EC_DEV_ALLOCATE                     ConsPrivate  See proposal.txt
ESC_ALLOCATE                        ConsPrivate  See proposal.txt
ESC_DEALLOCATE                      ConsPrivate  See proposal.txt

/dev/removable-media                Uncommitted  Logical namespace for devices
                                                 with 'removable-media' property
/dev/hotpluggable                   Uncommitted  Logical namespace for devices
                                                 with 'hotpluggable' property

============================================================================

Removed interfaces:

volfs(7FS)                          Obsolete
vold(1M)                            Obsolete
svc:/system/filesystem/volfs        Obsolete
vold.conf(4)                        Obsolete
rmmount.conf(4)                     Obsolete
volrmmount(1)                       Obsolete
volcancel(1)                        Obsolete
volmissing(1)                       Obsolete
/etc/init.d/volmgt                  Obsolete
/usr/lib/rmmount/*.so.1             Obsolete
/usr/lib/vold/*.so.1                Obsolete
/usr/lib/fs/*/ident_*.so.1          Obsolete
pkill(1M)'s -V option               Obsolete