Hal 规范

来源：互联网发布：淘宝可以代付吗编辑：程序博客网时间：2024/06/05 03:30

AL0.5.10 Specification

DavidZeuthen

<david@fubar.dk>

Version0.5.10

Tableof Contents

1.Introduction

About

Acknowledgements

Architectureof HAL

DeviceObjects

DeviceCapabilities

2.Device Information Files

Matching

Merging

SearchPaths

3.Access Control

DeviceFiles

D-BusInterfaces

4.Locking

Overview

Guidelines

5.Device Properties

GeneralProperties

infonamespace

Callouts

Addons

Methodcalls

Subsystem-SpecificProperties

pcinamespace

serialnamespace

usb_devicenamespace

usbnamespace

platformnamespace

ide_hostnamespace

idenamespace

scsi_hostnamespace

scsinamespace

ieee1394_hostnamespace

ieee1394_nodenamespace

ieee1394namespace

mmc_hostnamespace

mmcnamespace

ccwnamespace

ccwgroupnamespace

iucvnamespace

blocknamespace

xennamespace

bluetooth_hcinamespace

bluetooth_aclnamespace

bluetooth_sconamespace

FunctionalProperties

systemnamespace

volumenamespace

volume.discnamespace

storagenamespace

storage.cdromnamespace

storage.linux_raidnamespace

netnamespace

net.80203namespace

net.80211namespace

net.bluetoothnamespace

net.irdanamespace

net.80211controlnamespace

inputnamespace

input.keysnamespace

input.keypadnamespace

input.keyboardnamespace

input.mousenamespace

input.switchnamespace

input.joysticknamespace

input.tabletnamespace

input.keymapnamespace

pcmcia_socketnamespace

printernamespace

portable_audio_playernamespace

alsanamespace

ossnamespace

cameranamespace

scannernamespace

laptop_panelnamespace

ac_adapternamespace

batterynamespace

buttonnamespace

processornamespace

light_sensornamespace

power_managementnamespace

tapenamespace

killswitchnamespace

Misc.Properties

access_controlnamespace

DeprecatedProperties

6.D-Bus interfaces

org.freedesktop.Hal.Managerinterface

org.freedesktop.Hal.Deviceinterface

org.freedesktop.Hal.Device.SystemPowerManagementinterface

org.freedesktop.Hal.Device.CPUFreqinterface

org.freedesktop.Hal.Device.LaptopPanelinterface

org.freedesktop.Hal.Device.KeyboardBacklightinterface

org.freedesktop.Hal.Device.LightSensorinterface

org.freedesktop.Hal.Device.Storageinterface

org.freedesktop.Hal.Device.Volumeinterface

org.freedesktop.Hal.Device.Volume.Cryptointerface

org.freedesktop.Hal.Device.KillSwitchinterface

org.freedesktop.Hal.Device.AccessControlinterface

Chapter 1. Introduction

Tableof Contents

About

Acknowledgements

Architectureof HAL

DeviceObjects

DeviceCapabilities

About

Thisdocument concerns the specification of HAL which is a piece ofsoftware that provides a view of the various hardware attached to asystem. In addition to this, HAL keeps detailed metadata for eachpiece of hardware and provide hooks such that system- anddesktop-level software can react to changes in the hardwareconfiguration in order to maintain system policy.

该文档用于描述HAL规范，HAL提供了一个绑定于当前系统的各种硬件的视图。除此之外，HAL维护每一个硬件细节数据，并提供可以让应用程序对硬件配置的改变作出响应的系统和桌面级的钩子来维护系统策略。

HALrepresents a piece of hardware as a deviceobject. Adevice object is identified by a unique identifer and carries a setof key/value paris referred to as deviceproperties.Some properties are derived from the actual hardware, some are mergedfrom deviceinformation filesand some are related to the actual device configuration. Thisdocument specifies the set of device properties and gives themwell-defined meaning. This enable system and desktop level componentsto distinguish between the different device objects and discover andconfigure devices based on these properties.

HAL用deviceobject(设备对象)来表示硬件。每个设备对象使用一个唯一标识来标识，并随该标识附有一组键值属性。一些属性来自于实际的硬件，而另一些来自于deviceinfomationfiles(设备信息文件），还有来自于实际设备配置。该文档定义一组设备属性，并给予定义。这些可以使系统桌面级组件基于这些属性来区分不同设备对象，发现，配置设备的不同。

HALprovides an easy-to-use API through D-Bus which is an IPC frameworkthat, among other

things,provides a system-wide message-bus that allows applications to talkto one another. Specifically, D-Bus provides asynchronousnotification such that HAL can notify other peers on the message-buswhen devices are added and removed as well as when properties on adevice are changing.

HAL通过提供了系统范围总线进行进程间通信的IPC框架D-Bus提供易于使用的API。特别是，D-Bus提供一步通信记住，来使HAL可以在设备被插入，删除，或者设备的一个属性被改变时，来提示在总线上的其他节点。

Themost important goal of HAL is to provide plug-and-play facilities forUNIX-like desktops with focus on providing a rich and extensibledescription of device characteristics and features. HAL has no othermajor dependencies apart from D-Bus which, given sufficientinfrastructure, allows it to be implemented on many UNIX-likesystems. The major focus, initially, is systems running the Linux 2.6series kernels.

HAL最重要的目标是为在Unix类系统桌面上的即插即用设备提供丰富的可扩展的设备特征，HAL除了D-bus之外，没有其他的依赖，使其可以在众多的unix类系统实现。最初主要的焦点是，系统需要运行于2.6系列内核。

Acknowledgements

HavocPennington's article ''MakingHardware Just Work'' motivatedthis work. The specification and software would not exist without allthe useful ideas, suggestions, comments and patches from the FreeDesktopand HALmailing lists.

Alltrademarks mentioned belong to their respective owners.

HavocPennington 的文章 ''MakingHardware Just Work''描述了hal的开发动机。如果没有freedesktop和hal邮件列表当中的讨论，想法，评论，不定。就不会存在这样一个规范和软件。

Architecture of HAL

TheHAL consists of a number of components as outlined in the diagrambelow. Note that this diagram is high-level and doesn't capture allimplementation details.

hal由下图中的组件组成。该图是高层设计图并没有包含所有细节

Detailson each component

HALdaemon

Asystem-wide service that maintains a database of device objects. Thedaemon is responsible for merging information from device informationfiles and managing the life cycle of device objects. The service isimplemented as a daemon and uses helpers to query devices forspecific information.

一个维护设备对象数据库的系统级别服务。该守护进程附着合并设备信息文件的信息并管理设备对象生命周期。该服务被实现为一个守护进程并帮助查询设备专属的信息。

Applications

Theseare applications consuming services from HAL; this includesdesktop-wide session daemons for maintaining policy such as power anddisk/volume management.

这些应用程序使用hal的服务；其中包括桌面级别用来维护电源和磁盘管理的会话守护进程

Callouts

Calloutsare programs that run when device objects are added and removed inthe HAL daemon. This is useful for 3rd party software to mergeadditional information onto the device object before it is announcedon D-Bus. Callouts are specified on a per-device basis with theinfo.callouts.addand info.callouts.remove.See thesection called “ info namespace ”for details.

Callouts是当设备被插入或者移除的时候执行的程序。这对于第三方程序用来在dbus运行之前合并设备对象附加设备信息，Callouts被指定在每一个设备上，通过info.callouts.add和info.callouts.remove.

Methods

Itis possible to specify that a given HAL device object implements aspecific D-Bus interface, e.g. org.freedesktop.Hal.Device.Frobwith a set of methods Foo,Barand Bazand have programs run when applications call into this interface.This is defined in the info.interfacesproperty, consult thesection called “ info namespace ”for details.

指定一个hal给定的设备对象实现一个特定的d-bus接口。Org.freedesktop.Hal.Device.Frob由Foo,Bar和Baz一组方法，并在当有应用程序调用接口时运行一个程序。位于info.interfaces中定义。

Addons

Anaddoncan be characterized as a daemon whose life cycle is tied to a deviceobject in HAL. And addon can also claima specific interface on the device object to provide services toapplications for configuring / using the device without having tospawn a new program for every method call. HAL provides a facility tolaunch/destroy one or more addons per device object using theinfo.addonsproperty. See thesection called “ info namespace ”for details.

一个addon可以作为一个守护进程，它的生命周期与设备对象的绑定在一起。并且addon可以在设备对象上声明一个特定的接口来提供服务给应用程序配置和使用设备。这样不需要为每一个调用派生一个新的程序。Hal通过info.addons属性提供了加载和销毁每个设备上一个或多个addons。

DeviceInformation Files

Aset of files that matches properties on device objects and mergesadditional information. These files are used, for among other things,to specify what callouts, methods and addons to associate with adevice object. For example, for drives using removable media, HALincludes an add-on daemon which sole purpose is to continously pollthe drive to detect media change.

一组匹配设备对象属性和合并设备附加信息的文件。这些文件被用来指定那些callouts方法和addons绑定于一个设备对象。例如，驱动一个设备对象。HAL包含一个andon守护进程，唯一的目的是持续的检查媒体是否该百年

TheD-Bus system message bus is used to provide a ''network API'' toapplications. As D-Bus is designed to be language independent,potentially many languages / runtime systems will be able to easilyaccess the services offered by HAL.

dbus系统消息总线被用来提供网络api给应用程序。正如d-bus被设计成语言无关，使hal的服务可以使用任何语言和运行时系统来访问。

Device Objects

Itis important to precisely define the term HAL device object. It'sactually a bit blurry to define in general, it includes what mostUNIX-like systems consider first class objects when it comes tohardware. In particular, a device object should represent thesmallest unit of addressable hardware. This means there can be aone-to-many relationship between a physical device and the deviceobjects exported by HAL. Specifically, a multi-function printer,which appear to users as a single device may show up as severaldevice objects; e.g. one HAL device object for each of the printing,scanning, fax and storage interfaces. Conversely, some devices may beimplemented such that the HAL device object represent severalfunctional interfaces. HAL is not concerned with this duality ofeither one-to-many or many-to-one relationships between deviceobjects and the actual iron constituting what users normallyunderstand as a single piece of hardware; a device object representsthe smallest addressable unit.

最重要的是给hal设备对象一个定义。实际上它的定义有些模糊，它包含了unix类系统所认为的第一类对象。实际上，一个设备对象表示一个可以寻址硬件的最小单位。意味着通过hal可以导出物理设备到设备对象的一对多关系。特别是，一个多功能打印机，对用户来说一个设备是可以表示为多个设备对象。一个hal设备对象对应一个打印，扫描，传真存储接口。相反一个设备可以实现成一个hal设备对象表现为几个功能接口。hal并不关心设备对象和实际设备多对一还是一对多的关系来组成用户所懂得一个单独硬件；一个设备对象就表示一个最小寻址单元。

Deviceobjects in HAL are organised on a by-connection basis, e.g. for agiven device object X it is possible to find the device object Ywhere X is attached to Y. This gives structure to the device databaseof HAL; it is possible to map the devices out in a tree. Further,software emulation devices exported by the operating system kernel,such as SCSI emulation for USB Storage Devices, are also considereddevice objects in HAL. This implies that operating system kernelspecific bits leak into the device object database. Howeverapplications using HAL will not notice this, such device objects arenot referenced anywhere in the device objects that users areinterested in; they are merely used as glue to build the device tree.

在hal当中设备对象依赖基本连接组织一起。例如一个给定的设备对象X绑定于Y，则会尽可能的找到设备对象Y。这就是hal数据库的结构；会尽可能将设备映射到一颗树。然而，操作系统内核导出的软件模拟设备，如usb存储设备模拟的scsi也同样被hal认为是设备对象。这意味着操作系统内核特定位渗入到设备对象数据库当中。然而使用hal的应用程序并不会注意到这点，这样设备对象的不会引用到该用户感兴趣设备对象当中的的任何地方。它们仅仅是作为粘合剂绑定到设备树。

Inaddition to provide information about what kind of hardware a deviceobject represents (such as a PCI or USB device) and how to addressit, HAL merges information about the functional interfaces theoperating system kernel provides in order to use the device; in mostcases this is represented on the device object as a string propertywith the name of the special device file in /dev.In addition to the special device file, a number of other usefulproperties are merged. This means that both hardware and functionalproperties are on the same device object, which may prove to beuseful for an application programmer. For example, an applicationmight query HAL for the device object that exports the special devicefile /dev/input/mouse2and learn that this is provide by an USB mouse from a certainmanufacturer by checking the properties that export the USB vendorand product identifiers. See thesection called “Device Capabilities”and Chapter 5,DevicePropertiesfor details.

另外系统关于设备对象的类型（如pci或者usb设备）和如何寻址的信息，hal合并关于操作系统内核提供的功能接口来使用设备；大多数情况是设备对象中的一个字符串属性包含指定设备对象。另外特定的设备文件有一些其他的有用信息合并进来。这就意味着硬件和功能属性位于同一个设备对象当中，证明了对于程序开发人员很有用。例如，一个应用程序可以查询hal的设备对象/dev/input/mouse2并且通过检查设备对象到处的usb厂商和产品标识获知这是一个usb鼠标。

Finally,HAL provides one or more D-Businterfacesfor applications to configure and/or use the device. These interfacesare discussed in Chapter 6,D-Businterfaces.

Summarizing,a device object is comprised by

最后，hal会提供一个或多个dbus接口给应用程序配置和使用设备。这下接口会在第6章集中讨论。一个设备对象的组成如下：

UDI

Thisis the the UniqueDevice Identifer,that is unique for a device object - that is, no other device objectcan have the same UDI at the same time. The UDI is computed usingbus-specific information and is meant to be unique across deviceinsertions and independent of the physical port or slot the devicemay be plugged into.

这是一个唯一标识，它唯一的标识了一个设备对象。不会同时有两个设备使用同样的UDI。UDI通过总线规格信息计算出来并且不依赖所插入的物理接口。

Properties

Eachdevice object got a set of properties which are key/value pairs. Thekey is an ASCII string while the value can be one of several types,see below. Properties are arranged into name spaces using ''.'' as aseparator.

每个设备对象得到一组键/值属性对。key为ASCII字符串，属性值可以是多种类型。属性名称通过‘.'为分割符的名字空间中排列

- string- UTF8 string
- strlist- ordered list with UTF8 strings
- int- 32-bit signed integer
- uint64- 64-bit unsigned integer
- bool- truth value
- double- IEEE754 double precision floating point number

Interfaces

Applicationscan configure and/or use a device using D-Bus interfaces. Typically,there's a one-to-one relationship between capabilities/namespaces andinterfaces.

Propertiesof a device object carry all the important information about a deviceobject. For organisational reasons properties are also namespacedusing ''.'' as a separator.

应用程序可以通过dbus接口配置和使用设备。通常，接口和功能是一对一的关系。属性承载了设备对象的所有重要信息。仍然通过”.”作为分割符作为名字空间组织。

Itcan be useful to classify properties into four groups

属性通常被分来为四组。

Metadata- Information about how the devices are connected with respect toeach other (parent/child relationships), what kind of device it is,what functionality it provides etc.

元数据－关于设备如何互相连接的信息，以及是何种设备和提供何种功能。

Facts- vendor ID, product ID, disk serial numbers, number of buttons on amouse, formats accepted by a mp3 player and so on.
Facts -厂商ID，产品ID，磁盘序列号，在鼠标上的按钮数量，mp3播放器支持格式等等。
Usagespecific information - Network link status, special device filename, filesystem mount location etc.

使用规格信息－网络连接状态，指定的设备文件名，文件系统加载等等。

Policy- How the device is to be used be users; usually defined by thesystem administrator.

策略，设备如何被用户使用；通常被系统管理员来指定。

Thefirst category is determined by HAL, the second category includesinformation merged from either querying the hardware itself or fromdevice information files. The third category is intercepted bymonitoring the hardware and finally the last is merged from filesunder control of the system administrator. This document is concernedwith precisely defining several properties; see Chapter 5,DevicePropertiesand onwards for more information. As a complement to deviceproperties, HAL also provides conditionson HAL device objects. Conditions are used to relay events that arehappening on devices which are not easily expressed in properties.This includes events such as ''processor is overheating'' or ''blockdevice unmounted''.

第一类是由HAL检测出来的，第二类包括从设备硬件查询的信息和设备信息文件合并而来的。第三类通过监视硬件被解析和最终合并系统管理员的配置文件。该文档关系这些属性的定义。更多的信息在第五章介绍。作为设备属性的一个补充，hal在设备对象上提供conditions。conditions用来延迟很难属性表达的设备时间。包括时间有处理器过热，块设备未加载。

Thereis a special hal device object referred to as the ''root computerdevice object''. This device object represent the entire system as awhole and all other devices are either directly or indirectly childsof this device object. It has the UDI/org/freedesktop/Hal/devices/computer.

这里有一个特殊的hal设备对象引用到“rootcomputer设备对象”。该设备对象表示整个系统和所有其他设备对象直接活间接的父设备对象。它的udi是/org/freedesktop/Hal/devices/computer.

Thefundamental idea about HAL is that all ''interesting'' informationabout hardware that a desktop application needs, can be obtained byquerying HAL. Below is a screenshot of a simple device managerapplication shipped with HAL called hal-device-manager.This application is communicating with the HAL daemon and displaysthe tree of device objects. The shown properties are for a deviceobject representing a harddisk.

关于hal的基本想法是所有应用程序感兴趣的硬件信息可以通过hal查询。下面是一个简单的设备管理应用程序的截图，程序名为hal-device-manager。该应用程序与hal守护进程通信并显示设备对象树。显示的是一个硬盘设备对象。

Device Capabilities

Mainstreamhardware isn't very good at reporting what it really is, it onlyreports, at best, how to interact with it. This is a problem; manydevices, such as MP3 players or digital still cameras, appear to theoperating system as plain USB Mass Storage devices when the device infact is a lot more than just that. The core of the problem is thatwithout external metadata, the operating system and desktopenvironment will present it to the user as just e.g. a mass storagedevice.

主流硬件不是非常善于报告它是什么，最好的情况下，它仅报告如何和它交互。这是个问题。许多设备，如mp3播放器或者数码相机，展现给操作系统的是一个普通usb存储设备，但实际上设备要比那个复杂。这个问题的核心是没有额外的元数据，操作系统和桌面缓建将会提供给用户的仅仅是存储设备。

AsHAL is concerned with merging of external metadata, through e.g.device information files, there needs to be some scheme on how torecord what the device actually is. This is achieved by two textualproperties, info.categoryand info.capabilities.The former describes whatthe device is(as a single alphanumeric keyword) and the latter describes whatthe device does(as a number of alphanumeric keywords separated by whitespace). Thekeywords available for use is defined in this document; we'll referto them in following simply as capabilities.

hal所关心的合并外部数据，通过设备信息文件，这些需要一些scheme记录设备是什么。该文档通过两个属性，info.categoryandinfo.capabilities.前一个描述了设备是什么（作为一个单独的字符关键字），后者描述设备能做什么（一组字符关键字通过空格分割）。关键该文档中定义，我们将引用他们做外简单capabilities.

HALitself, assigns capabilities on device detection time by inspectingthe device class (if available, it depends on the bus type) andlooking at information from the operating system and the hardwareitself.

Hal自己在设备检测的时候通过检测设备类（如果可用，这依赖设备类型）并从操作系统硬件查询设备信息来赋予capabilities。

Usermode drivers such as libgphoto2and saneprovides device information to merge information about devices theycan drive. As such, device objects represent an USB interface gainadditional properties such as ''scanner'' or ''camera''.

用户模式驱动像libgphoto2和sane提供设备信息合并关于他们可以驱动何种设备，例如设备对象表示为一个usb借口获得附加属性scanner或者camera.

Havinga capability also means that part of the property namespace, prefixedwith the capability name, will be populated with more specificinformation about the capability. Indeed, some properties may even berequired such that applications and device libraries have somethingto expect. For instance, the capability for being a MP3 player mayrequire properties defining what audio formats the device support(e.g. Ogg and MP3), whether it support recording of audio, and how tointeract with the device. For example, the latter may specify ''USBStorage Device'' or ''proprietary protocol, use libfooplayer''.

拥有一种能力也意味这能属性的名字空间，有能力的填充，需要更多指定信息关于capability。一些应用程序和设备库要求一些属性。例如，mp3播放器的功能要求属性定义支持什么样的格式。是否能录音，如何与设备交互，例如后者可以指定usb存储设备，属性协议，使用libfooplayer。

Finally,capabilities have an inheritance scheme, e.g. if a device has acapability foo.bar,it must also have the capability foo.

最后，功能可以继承，例如一个设备有foo.bar功能，它也必须有foo功能。

Chapter 2. DeviceInformation Files

Tableof Contents

Matching

Merging

SearchPaths

Deviceinformation files (.fdifiles is a shorthand) are used to merge arbitrary properties ontodevice objects. The way device information files works is that onceall device properties are merged onto a device object it is triedagainst the set of installed device information files. Deviceinformation files are used for both merging facts and policy settingsabout devices.

设备信息文件(.fdi是缩写）用来合并设备上的专属信息。设备信息文件的工作方式是一旦所有设备属性被合并到设备对象上后它一定依赖所有安装的设备信息文件。设备信息文件被用来合并所有因素和所有关于设备的策略设置。

Matching

Eachdevice information file got a number of <matchkey="some_property" [string|int|bool|..]="required_value"> directivesthat is tested against the properties of the device object. If allthe match directives passes then the device information can include<[merge|append|prepend|addset]key="some_property" type="[string|int|bool|..]">directives torespectively merge new properties or append to existing properties onthe device object. It's important to emphasize that any previouslyproperty stemming from device detection can be overridden by a deviceinformation file.

The<match>,<merge>,<append>,<prepend>and <addset>directives always requires the keyattribute which must be either a property name on the device objectin question or a path to a property on another device object. Thelatter case is expressed either through direct specification of theUDI, such as /org/freedesktop/Hal/devices/computer:foo.baror indirect references such as @info.parent:bazwhere the latter means that the device object specified by the UDI inthe string property info.parentshould be used to query the property baz.It is also possible to use multiple indirections, e.g. for a volumeon a USB memory stick the indirection@block.storage_device:@storage.originating_device:usb.vendor_idwill reference the usb.vendor_idproperty on the device object representing the USB interface.

<match>,<merge>,<append>,<prepend>and<addset>总是要求key属性，该属性是设备对象一个属性上的或一个到另一个设备对象属性。后面的情况是表达任意通过直接UDI规范。像/org/freedesktop/Hal/devices/computer:foo.bar或者间接引用像@info.parent:baz，意思是查询nfo.parent属性值指定设备对象的属性baz.也可能用于多重间接，例如usb存储卡的一个分区的间接引用@block.storage_device:@storage.originating_device:usb.vendor_id，表示将要引用usb接口表现的设备对象usb.vendor_id属性。

Whenthe property to match have been determined a number of attributes canbe used within the <match>tag:

大量的属性可以用户match标记：

string- match a string property; for example <matchkey="foo.bar" string="baz">will match only if 'foo.bar' is a string property assuming the value'baz'. 匹配一个字符属性
int- match an integer property 匹配一个整形属性
uint64- match property with the 64-bit unsigned type 匹配一个无符号64位这个女性值
bool- match a boolean property 匹配一个布尔值
double- match a property of type double 匹配一个double类似
exists- used as <matchkey="foo.bar" exists="true">.Can be used with 'true' and 'false' respectively to match when aproperty exists and it doesn't.
empty- can only be used on string or strlist properties with 'true' and'false'. The semantics for 'true' is to match only when the stringis non-empty.
is_ascii- matches only when a string property contain only ASCII characters.Can be used with 'true' or 'false'.
is_absolute_path- matches only when a string property represents an absolute path(the path doesn't have to exist). Can be used with 'true' or'false'.
sibling_contains- can only be used with string and strlist (string list). For astring key this matches when a sibling item contains the(sub-)string in the same property. For a string list, this is if astring matches an item in the list.
contains- can only be used with string and strlist (string list). For astring key this matches when the property contains the given(sub-)string. For a string list this match if the given string matcha item of the list.
contains_ncase- like containsbut the property and the given key are converted to lowercase beforecheck.
contains_not- can only be used with strlist (string list) and string properties.For a string list this match if the given string not match any ofthe item of the list (or the property is not set for the device).For a string this match of the property not contains the(sub-)string. You can use this attribute to construct if/else blockstogether with e.g. contains.
prefix- can only be used with string properties. Matches if propertybegins with the key.
prefix_ncase- like prefixbut the property and the given key are converted to lowercase beforethe check.
suffix- can only be used with string properties. Matches if property endswith the key.
suffix_ncase- like suffixbut the property and the given key are converted to lowercase beforethe check.
compare_lt- can be used on int, uint64, double and string properties tocompare with a constant. Matches when the given property is lessthan the given constant using the default ordering.
compare_le- like compare_ltbut matches when less than or equal.
compare_gt- like compare_ltbut matches when greater than.
compare_ge- like compare_ltbut matches when greater than or equal.
compare_ne- like compare_ltbut matches when not equal.

Merging

The<merge>,<append>,<prepend>and <addset>directives all require the typeattribute which specifies what to merge. The following values aresupported

string- The value is copied to the property. For example <mergekey="foo.bar" type="string">baz</merge>will merge the value 'baz' into the property 'foo.bar'.
strlist- For <merge>the value is copied to the property and the current property will beoverwritten. For <append>and <prepend>the value is append or prepend to the list as new item. For <addset>the strlist is treated as a set and the value is appended if, andonly if, the value doesn't exist already. Usage of <copy_property>overwrite the complete list with the value of the given property tocopy from.
bool- Can merge the values 'true' or 'false'
int- Merges an integer
uint64- Merges an unsigned 64-bit integer
double- Merges a double precision floating point number
copy_property- Copies the value of a given property - supports paths with directand indirect UDI's. For example <mergekey="foo.bar"type="copy_property">@info.parent:baz.bat</merge>will merge the value of the property baz.baton the device object with the UDI from the property info.parentinto the property foo.baron the device object being processed.

The<remove>,directive require only a key and can be used with all keys. Forstrlistthere is additionally a special syntax to remove a item from thestring list. For example to remove item 'bla' from property'foo.bar': <removekey="foo.bar" type="strlist">bla</remove>

Search Paths

DeviceInformation files are read from two directories

/usr/share/hal/fdi- for files provided by packages

包提供的文件

/etc/hal/fdi- for files provided by the system administrator / user

由系统管理员和用户提供的文件

inexactly that order. This means that the files provided by the systemadministrator will be processed last such that they can overwrite /change properties caused by the device information files provided bypackages. The following directory structure is used in/usr/share/hal/fdi

系统管理员提供的文件应该被靠后处理，以至于他们可以覆盖包提供设置。以下是/usr/share/hal/fdi的目录结构：

information- device information files used to merge device information

设备信息文件用来合并设备信息

- 10freedesktop- included with the hal package

hal包包含的

- 20thirdparty- from a 3rd party, not included in hal package

第三方的不包含在hal当中

policy- device information files to merge policy properties such as addonsor callouts.

设备信息文件合并策略属性，如addons和callouts

- 10osvendor－includedwith the hal package

- 20thirdparty- from a 3rd party, not included in hal package

preprobe- device information files read before probing devices

在检测设备之前都的设备信息文件

- 10osvendor- included with the hal package
- 20thirdparty- from a 3rd party, not included in hal package

Asevident, third party packages should drop device information files in

很明显，第三方包的设备信息文件应该放入一下几个目录中

/usr/share/hal/fdi/information/20thirdparty
/usr/share/hal/fdi/policy/20thirdparty
/usr/share/hal/fdi/preprobe/20thirdparty

The/etc/hal/fditree uses this layout

information- device information files used to merge device information
policy- device information files to merge policy properties such as addonsor callouts.
preprobe- device information files to read before probing devices

Alldevice information files are matched for every hal device object inthe following order.

所有设备信息文件都被通过一下顺序来匹配每个hal设备对象。

Whena device is discovered, the preprobedevice information files (e.g. all files from/usr/share/hal/fdi/preprobeand /etc/hal/fdi/preprobe)are processed.

Typically,this class of device information files is used to tell HAL to leavethe device alone by setting the bool property info.ignoreto TRUE. It can also be used to run programs, preprobe callouts,prior to normal device investigation.

当一个设备被发现，preprobe的设备信息文件(e.g.all files from /usr/share/hal/fdi/preprobeand /etc/hal/fdi/preprobe)将被处理

典型的。这类设备信息文件被用来告诉hal通过设置属性info.ignore来把设备独立。

HALnow runs the preprobe callouts.

hal运行preprobe的callouts

HALnow probes/investigates the device.

hal现在检测设备

Allthe informationdevice information files (e.g. all files from/usr/share/hal/fdi/informationand /etc/hal/fdi/information)are processed.

Thesedevice information files are typically used to associate extrainformation with a device object.

所有设备信息文件(e.g.all files from /usr/share/hal/fdi/informationand /etc/hal/fdi/information)被处理。这些设备信息文件被典型的用来关联而外的设备对象信息。

Allthe policypolicy information files (e.g. all files from/usr/share/hal/fdi/policyand /etc/hal/fdi/policy)are processed.

Thesedevice information files are typically used to associate callouts andaddons with a device object.

所有的策略信息文件被处理。这些设备信息文件被典型的用来关联callouts和addons

HALnow runs the callouts, starts addons, and then finally announces thedevice on the system message bus.

hal开始运行callouts，运行addons。最终在系统消息总线上声明设备。

Chapter3. Access Control

Tableof Contents

DeviceFiles

D-BusInterfaces

Accessto hardware by unprivileged users is traditionally granted in twoways either by granting access to the special device file or allowingaccess through another process, using IPC acting on behalf of theuser. HAL follows the latter model and uses the system-wide messagebus (D-Bus) as the IPC mechanism. In addition, HAL has support formodifying the ACL's (access control lists) on a device file togrant/revoke access to users based on several criteria.

无权限的用户访问硬件通常被授予权限通过两种方式，一种是获得访问指定设备文件或者通过ipc机制代替该用户在其他进程得到访问权限。hal使用后者并通过d-bus的系统范围总线作为ipc机制。另外，hal支持修改设备文件的acl来获得和拒绝用户的访问。

DeviceFiles

IfHAL is built with --enable-acl-management (requires both--enable-console-kit and --enable-policy-kit) then ACL's on deviceobjects with the capability access_control are automatically managedaccording to the properties defined in thesection called “ access_control namespace ”.In addition, for this configuration, HAL ships with a deviceinformation file (normally installed in/usr/share/hal/fdi/policy/10osvendor/20-acl-management.fdi) thatmerges this capability on device objects that are normally accessedby unprivileged users through the device file. This includes e.g.sound cards, webcams and other devices but excludes drives andvolumes as the latter two are normally accessed by a user throughmounting them into the file system.

如果hal构建时，带有--enable-acl-management(同时要求--enable-console-kitand --enable-policy-kit) ,则设备对象的acl会有访问控制的能力。并通过属性进行自动管理。该内容在”accesscontrolnamespace定义。另外，为了该配置，hal传送一个设备信息文件。（通常安装在/usr/share/hal/fdi/policy/10osvendor/20-acl-management.fdi），该文件用来合并该能力到被无权用户访问的设备的设备对象上。这包括，声卡，摄像头和其他设备，但排除了磁盘和卷被加在后同查跟你被用户通过加载到文件系统中使用。

HALuses PolicyKit to decide what users should have access according toPolicyKit configuration; see the PolicyKit privilege definition file/etc/PolicyKit/privileges/hal-device-file.priv on a system with HALinstalled for the default access suggested by the HAL package and/orOS vendor.

hal使用policykit通过policykit的配置来决定什么用户可以访问。在系统安装hal时会提供默认的policykit权限定义文件/etc/PolicyKit/privileges/hal-device-file.priv

Inaddition, 3rd party packages can supply device information files tospecify (via the access_control.grant_user andaccess_control.grant_group properties) that a given user or groupshould always have access to a device file. This is useful forsystem-wide software (such as AV streaming management) that runs asan unprivileged system user. This interface is supposed to be stableso 3rd party packages can depend on it.

另外，第三方软件包可以提供设备信息文件指定一个给定的用户和组总是可以访问一个设备文件(通过access_control.grant_userand access_control.grant_group 属性)。一个有用的系统级软件。这个接口被指定稳定所以第三方软件包可以被依赖。

D-BusInterfaces

IfHAL is built without ConsoleKit support (e.g. without--enable-console-kit) access to the various D-Bus interfaces thatprovides mechanisms is only protected by the D-Bus securityconfiguration files (e.g. using at_console to restrict to consoleuser on Red Hat systems) and, in certain cases, restricted to thesuper user.

如果hal内建不包含consolekit支持来访问dbus接口，则该机制只能由dbus安全配置文件来提供（没有--enable-console-kit选项），在某种情况，限制超级用户。

IfConsoleKit support is enabled, access to D-Bus interfaces iscurrently hardcoded to only allow active users at the system console.If PolicyKit support is enabled, the PolicyKit library will be incharge of determining access; see the PolicyKit privilege definitionfiles in /etc/PolicyKit/privileges on a system with HAL installed forthe default access suggested by the HAL package and/or OS vendor.

如果consolekit支持启用，访问d-bus接口是当前硬编码只允许激活用户在系统控制台。如果policykit支持，policykit库负责坚持访问。查看policykit权限定义文件在/etc/polikcykit/privileges中

Chapter4. Locking

Tableof Contents

Overview

Guidelines

AsHAL is a mechanism that enables programs in a desktop session toenforce the policy of the users choice, unexpected things can happen.For example, if the user is in the middle of partitioning a diskdrive, it is desirable to keep the desktop from mounting partitionsthat have not yet been prepared with a suitable file system. In fact,in such a situation data loss may be the result if a volume have anold file system signature indicating it's mountable and,simultenously, another tool is writing to the raw block device. Themechanism that automounters use, HAL, provides locking primitives toavoid this.

正如hal是一个使程序可以在桌面会话当中执行用户的策略，可能有无法预期的事情可能发生。例如，如果一个用户希望加载一个还未有合适文件系统的分区。事实上，在这种情况下如果一个分区带有一个就得文件系统特这个你显示他可以被加载，并同时另一个工具在原始块设备上写数据，会导致数据丢失。自动磁盘挂载工具使用hal提供的锁来避免这些。

Further,for multi-user systems, several desktop sessions may run on a systemeach on their own display. Suppose that one session becomes idle andthe power management daemon in that session decides to suspend thesystem according to user preferences in the idle session. The resultis that users at other seats will see the system suspend and this isnot desirable. The power management daemons in all sessions need tocooperate to ensure that the system only suspends when e.g. allsessions are idle or not at all. The mechanism that each powermanagement daemon uses, HAL, provides locking primitives that can beused to achieve this.

此外，对于多用户系统，几个桌面绘画会同时运行在一个系统中，每一个会话拥有自己的显示器。假设一个会话变得空闲并且电源管理进程决定暂停系统。这会导致其他用户看到系统暂停并且不愿意看到。在所有会话当中，电源管理进程需要在所有会话都空闲的时候才暂停系统。每个电源管理进程都使用hal提供的锁，来完成这个。

Overview

HALprovides a mechanism to lock a specific D-Bus interface either for aspecific device or for all the devices the caller have access to.

hal提供一个机制来锁住指定设备或者所有设备的dbus接口。

Theformer is achieved by using the AcquireInterfaceLock() andReleaseInterfaceLock() methods on the org.freedesktop.Hal.Deviceinterface that every device object implements (see thesection called “org.freedesktop.Hal.Device interface”).By using this API, a caller can prevent any other caller frominvoking methods on the given interface for the given device object -other callers will simply see theorg.freedesktop.Hal.Device.InterfaceLocked exception if they attemptto invoke a method on the given interface on the given device. Thelocker can specify whether the lock is exclusive meaning if multipleclients clients can hold the lock or if only one client can hold thelock at one time. If a client don't have access to the interface ofthe device, attempts to lock will fail with aorg.freedesktop.Hal.PermissionDenied exception. If a client losesaccess to a device (say, if his session is switched away from usingfast user switching) while holding a lock, he will lose the lock;this can be tracked by listening to the InterfaceLockReleased signal.

前者通过每个设备都实现的接口org.freedesktop.Hal.Device的AcquireInterfaceLock()和ReleaseInterfaceLock()方法完成锁定。通过使用该api，调用者可以防止任何其他调用者调用给定设备对象的给定接口。如果其他的调用者打算调用这个指定设备对象指定的接口，只会看到org.freedesktop.Hal.Device.InterfaceLocked异常。如果一个客户当持有锁的时候，丢失了对一个设备访问（如果他的会话通过快速用户切换被切换），他将会丢失该锁。这可以通过InterfaceLockReleased信号监听。

Alllocal clients, whether they are active or not, can always lockinterfaces on the root computer device object (this doesn't mean thatthey are privileged to use the interfaces though) - the rationale isthat this device object represents shared infrastructure, e.g. powermanagement, and even inactive sessions needs to participate inmanaging this.

所有本地客户端，无论他们是否激活，他们总是可以锁定rootcomputer设备对象接口（这不以为着他们有权限使用该接口）该原理是设备对象爱嗯表现为共享架构，如电源管理，其实非激活绘画仍需要参与管理。

Ifanother client already holds a lock exclusively, attempts from otherclients to acquire the lock will fail with theorg.freedesktop.Hal.Device.InterfaceAlreadyLocked exception even ifthey have access to the device.

如果另一个客户端已经互斥的持有一个锁，其他用户打算请求该锁将会错误，并产生org.freedesktop.Hal.Device.InterfaceAlreadyLocked异常，即使他们有权限访问。

Inaddition, a client may opt to lock all devices that he got access toby using the AcquireGlobalInterfaceLock() andReleaseGlobalInterfaceLock() methods on theorg.freedesktop.Hal.Manager interface on the/org/freedesktop/Hal/Manager object (see thesection called “org.freedesktop.Hal.Managerinterface”).Global interface locks can also be obtained exclusively if the callerso desires. Unlike per-device interface locking, it is not checked atlocking time whether the locker have access to a given device;instead checking is done when callers attempt to access theinterface.

另外，一个客户端可以锁定所有设备，通过AcquireGlobalInterfaceLock()and ReleaseGlobalInterfaceLock()方法在org.freedesktop.Hal.Manager对象的org.freedesktop.Hal.Manager接口中。如果调用者愿意，全局接口锁同样可以互斥。不像每个设备接口锁，当锁定时它不会检查锁定者是否访问给定设备。当调用者访问接口时才检查。

Thealgorithm used for determining if a caller is locked out is shownbelow. A caller A is locked out of an interface IFACE on a deviceobject DEVICE if, and only if,

该算法是解决是否一个调用者被拒绝锁定。一个调用者A锁定DEVICE设备对象IFACE接口被拒绝

1. Anothercaller B is holding a lock on the interface IFACE on DEVICE and Adon't have either a global lock on IFACE or a lock on IFACE onDEVICE; or
2. 另一个调用者B持有一个所在DEVICE的IFACE接口上并且A没有全局锁IFACE或者DEVICE的IFACE
3. Anothercaller B is holding the global lock on the interface IFACE and Bhas access to DEVICE and and A don't have either a global lock onIFACE or a lock on IFACE on DEVICE.
4. 另一个调用者B持有全局锁IFACE并且B访问DEVICE并且A没有其他全局锁在IFACE或者DEVICE的IFACE.

Inother words, a caller A can grab a global lock, but that doesn't meanA can lock other clients out of devices that A doesn't have accessto. Specifically a caller is never locked out if he has locked aninterface either globally or on the device in question. However, iftwo clients have a lock on a device, then both can access it. Toensure that everyone is locked out, a caller needs to use anexclusive lock.

换句话说，调用者A可以捕获一个全局锁，但是不意味着A可以锁定A没有权限访问的其他接口，特别是一个调用者觉不可以

Notethat certain interfaces will also check whether other locks are beingheld on other device objects. This is specified on a per-interfacebasis in Chapter6, D-Businterfaces.

Ifa process holding locks disconnects from the system bus, the locksbeing held by that process will be released.

Guidelines

Lockingis only useful if applications requiring exclusive access actuallyuse the locking primitives to cooperate with other applications. Hereis a list of guidelines.

锁仅对想要通过排斥其他访问与其他应用程序合作的应用程序有用。这里是一个向导列表。

DiskManagement / Partitioning

Inorder to prevent HAL-based automounters from mounting partitions thatare being prepared, applications that access block devices directly(and pokes the kernel to reload the partitioning table) should lockout automounters by either a) obtaining theorg.freedesktop.Hal.Device.Storage lock on each drive beingprocessed; or b) obtaintaing the globalorg.freedesktop.Hal.Device.Storage lock. This includes programs likefdisk, gparted, parted and operating system installers. See also thesection called “org.freedesktop.Hal.Device.Volume interface”and the hal-lock(1) program and manual page.

为了防止基于hal的自动加载器加载正在准备分区，直接访问块设备的应用程序（直接通过内核重新加载分区表）将被排除获得将被处理的每个设备的org.freedesktop.Hal.Device.Storage锁或者获得org.freedesktop.Hal.Device.Storage的全局锁。这些程序包括fdisk,gparted, parted 和操作系统安装程序。

PowerManagement

- Typically,a desktop session includes a session-wide power management daemonthat enforces the policy of the users choice, e.g. whether thesystem should suspend to ram on lid close, whether to hibernate thesystem after the user being idle for 30 minutes and so on. In amulti-user setup (both fast user switching and multi-seat), thiscan break in various interesting ways unless the power managementdaemons cooperate. Also, there may be software running at thesystem level who will want to inhibit a desktop session powermanagement daemon from suspending / shutting down.
- 典型的，一个桌面绘画包含一个会话范围的电源管理守护进程强制用户选择策略。例如系统是否应该暂停，是否暂停系统当用户空闲30分钟。在多用户环境中，这可以被多种方式大乱，除非电源管理进程互相合作。同样，这里需要一个软件运行于系统级别，它会禁止一个桌面会话管理进程暂停系统。

System-levelsoftware that do not wish to be interrupted by the effect of someonecalling into the org.freedesktop.Hal.Device.SystemPowerManagementinterface MUST hold theorg.freedesktop.Hal.Device.SystemPowerManagement lock non-exclusivelyon the root computer device object. For example, the YUM softwareupdater should hold the lock when doing an RPM transaction.

系统级别软件不希望被调用org.freedesktop.Hal.Device.SystemPowerManagement接口而被中断。系统级别软件应该持有rootcomputer设备对象的org.freedesktop.Hal.Device.SystemPowerManagement的锁。例如YUM软件更新在执行RPM事务的时候就应该持有该锁。

Inaddition, any power management session daemon instance

另外，任何电源会话管理进程实例应该

...MUST hold the org.freedesktop.Hal.Device.SystemPowerManagement locknon-exclusively on the root computer device object unless it isprepared to call into this interface itself. This typically meansthat the PM daemon instance simply acquires the lock on start up andreleases it just before it calls into theorg.freedesktop.Hal.Device.SystemPowerManagement interface. In otherwords, the PM daemon instance needs to hold the lock exactly when itdoesn't want other PM daemon instances to call into theorg.freedesktop.Hal.Device.SystemPowerManagement interface. Thismeans that if the user have configured the PM daemon instance to goto sleep after 30 minutes of inactivity, the lock should be releasedthen.

持有在rootcomputer设备对象的org.freedesktop.Hal.Device.SystemPowerManagement的非排斥，除非它自己打算调用该借接口。这典型的以为这PM实例简单的要求启动并当的调用org.freedesktop.Hal.Device.SystemPowerManagement接口时才会释放。还句话说，PM进程实例需要把持该锁当PM不想其他PM调用org.freedesktop.Hal.Device.SystemPowerManagement接口。这意味着如果用户配置PM在空闲30分钟后释放锁。

...MUST not hold the lock when the session is inactive (fast userswitching) UNLESS an application in the session have explicitlycalled Inhibit() on the org.freedesktop.PowerManagement D-Bus sessionbus interface of the PM daemon.

不必在会话未激活的状况下持有锁。除非一个应用程序在绘画中显示的调用inhibit()在 org.freedesktop.PowerManagement

...MUST check that no other process is holding the lock (using theIsLockedByOthers method on the standard org.freedesktop.Hal.Deviceinterface) before calling into theorg.freedesktop.Hal.Device.SystemPowerManagement interface. Ifanother process is holding the lock, it means that either 1) anothersession is not prepared to call into theorg.freedesktop.Hal.Device.SystemPowerManagement interface; OR 2)some system-level software is holding the lock. The PM daemoninstance MUST respect this by not calling into theorg.freedesktop.Hal.Device.SystemPowerManagement interface itself.

在调用之前应该确保没有其他进程把持锁，如果其他进程持有该锁，则以为着其他会话没有准备好调用该接口，、或者一些系统级别软件持有该锁，则PM应该尊重不调用该接口。

However,any Power management daemon instance

...MAY prompt the user, if applicable, to ask if she still wants toperform the requested action (e.g. call into theorg.freedesktop.Hal.Device.SystemPowerManagement interface) despitethe fact that another process (possibly from another user) isindicating that it does not want the system to e.g. suspend. Only ifthe user agrees, the power management instance should call into theorg.freedesktop.Hal.Device.SystemPowerManagement interface.Typically, it's only useful to prompt the user with such questions ifthe request to call into theorg.freedesktop.Hal.Device.SystemPowerManagement interface originatesfrom user input, e.g. either a hotkey, the user clicking a suspendbutton in the UI or an application invoking the Suspend() method onthe org.freedesktop.PowerManagement D-Bus session interface of the PMdaemon.

应该提示用户，如果可用，去询问如果她仍然想要表现请求动作（如调用org.freedesktop.Hal.Device.SystemPowerManagement

...MAY ignore that other processes are holding the lock and call intothe org.freedesktop.Hal.Device.SystemPowerManagement interfaceanyway, but ONLY if if the request to call into theorg.freedesktop.Hal.Device.SystemPowerManagement interface originatedfrom e.g. lid close, critically low battery or other similarconditions.

...MAY still call SetPowerSave() on theorg.freedesktop.Hal.Device.SystemPowerManagement interface even ifother processes are holding the lock.