1N/A

1N/AThis file describe the layout of device information files in the hal

1N/Asource tree and their three different applications. It should serve as

1N/Aa brief guide for IHV's and third party open source projects on how to

1N/Aintegrate with hal.

1N/A

1N/ASaid third parties need to name their files in a unique manner using

1N/Athe following format: <organization>-[<model>]-[<purpose>].fdi. As a

1N/Adevice information file can be used to match several models the model

1N/Afield may be omitted (the <purpose> field may be useful if the <model>

1N/Afield is omitted). The filename of a device information file must

1N/Acontain only lowercase alphanumeric characters, the '-' and '_'

1N/Acharacters, and not any whitespace.

1N/A

1N/ADevice information files are processed in the following order:

1N/A

1N/A1. Preprobing

1N/A-------------

1N/A

1N/AContains device information files that are used to handle exceptional

1N/Aconditions such as telling hal to ignore a device and all children

1N/A(using info.ignore), run programs to upload firmware or configure

1N/Athe device in an otherwise non-standard way that is incompatible with

1N/Aprobing routines in hal (using info.callouts.preprobing) [1].

1N/A

1N/AThese files are processed BEFORE the device have been been probed.

1N/A

1N/ASubdirs are installed in $(sysconfdir)/hal/preprobe (e.g. /etc/hal/preprobe)

1N/A

1N/A preprobe

1N/A |-- 10osvendor # From the hal tarball and/or supplied by the os vendor

1N/A | # -> installs into /usr/share/hal/fdi/preprobe/10osvendor

1N/A |-- 20thirdparty # 3rd party projects and IHV's install here

1N/A | # -> installs into /usr/share/hal/fdi/preprobe/20thirdparty

1N/A `-- 30user # Installed by the user/admin

1N/A # -> installs into /etc/hal/fdi/preprobe/

1N/A

1N/A[1] : http://lists.freedesktop.org/archives/hal/2004-August/000858.html

1N/A

1N/A2. Information

1N/A--------------

1N/A

1N/AContains device information files that describe hardware such as what

1N/Akind of media a card reader uses (compact flash, memorystick etc),

1N/Awhat out-of-tree kernel drivers are needed, whether the device is a

1N/Acamera and not just a harddrive.

1N/A

1N/AThese files are processed AFTER the device have been probed but before

1N/Aany policy device information files.

1N/A

1N/ASubdirs are installed in $(datadir)/hal/fdi (e.g. /usr/share/hal/fdi)

1N/A

1N/A information

1N/A |-- 10freedesktop # From the hal tarball

1N/A | # -> installs into /usr/share/hal/fdi/information/10freedesktop

1N/A |-- 20thirdparty # 3rd party projects and IHV's install here

1N/A | # -> installs into /usr/share/hal/fdi/information/20thirdparty

1N/A `-- 30user # Installed by the user/admin

1N/A # -> installs into /etc/hal/fdi/information

1N/A

1N/A

1N/A3. Policy

1N/A---------

1N/A

1N/AContains device information files that describe policy for hardware

1N/Asuch as what callouts and addons to run for a device.

1N/A

1N/AThese files are processed AFTER the device have been been probed and

1N/Aalso AFTER the information device files have been processed

1N/A

1N/ASubdirs are installed in $(sysconfdir)/hal/policy (e.g. /etc/hal/policy)

1N/A

1N/A policy

1N/A |-- 10osvendor # From the hal tarball and/or supplied by the os vendor

1N/A | # -> installs into /usr/share/hal/fdi/policy/10freedesktop

1N/A |-- 20thirdparty # 3rd party projects and IHV's install here

1N/A | # -> installs into /usr/share/hal/fdi/policy/20thirdparty

1N/A `-- 30user # Installed by the user/admin

1N/A # -> installs into /etc/hal/fdi/policy

1N/A