1HAL-LOCK(1)                 General Commands Manual                HAL-LOCK(1)
2
3
4

NAME

6       hal-lock - lock an interface
7

SYNOPSIS

9       hal-lock [options]
10
11

DESCRIPTION

13       hal-lock can be used to acquire a lock on a given interface either on a
14       given device or globally. For more information about both the big  pic‐
15       ture and the semantics of HAL locks, refer to the HAL spec which can be
16       found in /usr/share/doc/hal-0.5.14/spec/hal-spec.html depending on  the
17       distribution.
18
19

OPTIONS

21       The following options are supported:
22
23       --interface
24              The name of the interface to lock.
25
26       --run  Program to run if the lock was acquired.
27
28       --udi  The UDI (Unique Device Identifier) of the device object. If this
29              is ommitted, the global lock will be tried.
30
31       --exclusive
32              Whether the lock can be held by others.
33
34       --exit-with-lock
35              Kill the program if the acquired lock is lost. This  only  makes
36              sense  if  you  pass  a specific UDI due to the semantics of HAL
37              locks.
38
39       --exit-with-dev
40              Kill the program if the device is removed. This only makes sense
41              if you pass a specific UDI due to the semantics of HAL locks.
42
43       --help Print out usage.
44
45       --version
46              Print the version.
47
48

RETURN VALUE

50       This program will attempt to grab a lock on a given interface.  Unless,
51       a specific UDI is given, the global lock will be tried.   If  the  lock
52       was succesfully acquired the program specified by the option --run will
53       be run and upon termination this program will exit with exit code 0. If
54       the  lock  wasn't  acquired  or an error occured while taking the lock,
55       this program will exit with a non-zero exit code and the given  program
56       will not be run.
57
58
59

NOTES

61       This program is only useful for launching software that doesn't use HAL
62       at all (since such software launched using hal-lock would be locked out
63       itself);  for example a partition table editor part-foo may use wrapper
64       script like this
65
66       hal-lock  --interface  org.freedesktop.Hal.Device.Storage   --exclusive
67       --run /path/to/part-foo-program
68
69

BUGS

71       Please  send  bug reports to either the distribution or the HAL mailing
72       list, see http://lists.freedesktop.org/mailman/listinfo/hal on  how  to
73       subscribe.
74
75

SEE ALSO

77       hald(8),  lshal(1), hal-get-property(1), hal-set-property(1), hal-find-
78       by-property(1), hal-find-by-capability(1)
79
80

AUTHOR

82       Written by David Zeuthen <david@fubar.dk> with a lot of help from  many
83       others.
84
85
86
87
88                                                                   HAL-LOCK(1)