HAL-SET-PROPERTY
Section: User Commands (1)
Index
Return to Main Contents
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, refer to the HAL spec which can be found in
/usr/share/doc/hal-0.5.13/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 passed is assumed to be decimal unless it's prefixed with
0x
or
x
for hexadecimal values.
- --uint64
-
Set value property of the property to a 64-bit unsigned integer. The
value passed 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 errors a non-zero the program will exit with a non-zero
exit code. Note that setting properties on the
HAL
device database usually requires super user privileges.
BUGS
Please send bug reports to either the distribution or the HAL
mailing list, see
http://lists.freedesktop.org/mailman/listinfo/hal
on how to subscribe.
SEE ALSO
hald(8),
lshal(1),
hal-get-property(1),
hal-find-by-property(1),
hal-find-by-capability(1)
AUTHOR
Written by David Zeuthen <david@fubar.dk> with a lot of help from many
others.