You are on page 1of 3

Name

hal-find-by-property - find device objects by property matching


Synopsis
hal-find-by-property [options]
Description
hal-get-property finds device object in the HAL device database by looking at de
vice properties. For more information about both the big picture and specific HA
L properties, refer to the HAL spec which can be found in /usr/share/doc/hal-0.5
.14/spec/hal-spec.html depending on the distribution.
Options
The following options are supported:
--key
The name of the property.
--string
String value of the property
--verbose
Verbose output.
--help
Print out usage.
--version
Print the version.
Return Value
If devices matching the given property are found each UDI (Unique Device Identif
ier) is printed on stdout and the program exits with exit code 0. If no devices
are found or an error occured, the program exits with a non-zero exit code.
Name
hal-find-by-capability - find device objects by capability matching
Synopsis
hal-find-by-capability [options]
Description
hal-get-capability finds device object in the HAL device database by looking at
device capabilities. For more information about both the big picture and specifi
c HAL properties, refer to the HAL spec which can be found in /usr/share/doc/hal
-0.5.14/spec/hal-spec.html depending on the distribution.
Options
The following options are supported:
--capability
The name of the capability.
--verbose
Verbose output.
--help
Print out usage.
--version
Print the version.
Return Value
If devices matching the given capability are found each UDI (Unique Device Ident
ifier) is printed on stdout and the program exits with exit code 0. If no device
s are found or an error occured, the program exits with a non-zero exit code.

Name
hal-get-property - get a property from a device object
Synopsis
hal-get-property [options]
Description
hal-get-property retrieves a property from a device object in the HAL device dat
abase. For more information about both the big picture and specific HAL properti
es, refer to the HAL spec which can be found in /usr/share/doc/hal-0.5.14/spec/h
al-spec.html depending on the distribution.
Options
The following options are supported:
--udi
The UDI (Unique Device Identifier) of the device object.
--key
The name of the property.
--hex
Show int32/uint64 values in hex (without a leading 0x).
--verbose
Verbose output.
--help
Print out usage.
--version
Print the version.
Return Value
If both the property and device object exists the value of the property is print
ed on stdout and the program will exit with exit code 0. Otherwise the exit code
will be non-zero.
Name
hal-set-property - set a property on a device object
Synopsis
hal-set-property [options]
Description
hal-set-property sets a property on a device object in the HAL device database.
For more information about both the big picture and specific HAL properties, ref
er to the HAL spec which can be found in /usr/share/doc/hal-0.5.14/spec/hal-spec
.html depending on the distribution.
Options
The following options are supported:
--udi
The UDI (Unique Device Identifier) of the device object.
--key
The name of the property.
--int
Set value property of the property to a 32-bit signed integer. The value pas
sed is assumed to be decimal unless it's prefixed with 0x or x for hexadecimal v
alues.
--uint64
Set value property of the property to a 64-bit unsigned integer. The value p
assed is assumed to be decimal unless it's prefixed with 0x or x for hexadecimal
values.
--string

Set value property of the property to a string.


--double
Set value property of the property to a floating point number.
--bool
Set value property of the property to boolean, e.g. true or false.
--strlist-pre
Prepend an item to a string list.
--strlist-post
Append an item to a string list.
--strlist-rem
Remove an item from a string list.
--remove
Remove a property.
--help
Print out usage.
--version
Print the version.
Return Value
If setting the property succeeds, this program will exit with exit code 0. On er
rors a non-zero the program will exit with a non-zero exit code. Note that setti
ng properties on the HAL device database usually requires super user privileges.

You might also like