HAL-LOCKSection: User Commands (1)
Index Return to Main Contents
NAMEhal-lock - lock an interface
hal-lock can be used to acquire a lock on a given interface either on a given device or globally. For more information about both the big picture and the semantics of HAL locks, refer to the HAL spec which can be found in /usr/doc/hal-0.5.10/spec/hal-spec.html depending on the distribution.
OPTIONSThe following options are supported:
- The name of the interface to lock.
- Program to run if the lock was acquired.
- The UDI (Unique Device Identifier) of the device object. If this is ommitted, the global lock will be tried.
- Whether the lock can be held by others.
- Kill the program if the acquired lock is lost. This only makes sense if you pass a specific UDI due to the semantics of HAL locks.
- Kill the program if the device is removed. This only makes sense if you pass a specific UDI due to the semantics of HAL locks.
- Print out usage.
Print the version.
This program will attempt to grab a lock on a given interface. Unless, a specific UDI is given, the global lock will be tried. If the lock was succesfully acquired the program specified by the option --run will be run and upon termination this program will exit with exit code 0. If the lock wasn't acquired or an error occured while taking the lock, this program will exit with a non-zero exit code and the given program will not be run.
This program is only useful for launching software that doesn't use HAL at all (since such software launched using hal-lock would be locked out itself); for example a partition table editor part-foo may use wrapper script like this
hal-lock --interface org.freedesktop.Hal.Device.Storage --exclusive --run /path/to/part-foo-program
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.
AUTHORWritten by David Zeuthen <firstname.lastname@example.org> with a lot of help from many others.