X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd-inhibit.xml;h=de2f264147e4d4888e721c8ee21685181eee2902;hb=0461f8cdc1d7b4afee2f2ff40fcaa3c7e26c662c;hp=c71a954428560ada2d2007bd85ec10881beb8791;hpb=4943c1c94ba751c98763f4232b4350481b22c90a;p=elogind.git
diff --git a/man/systemd-inhibit.xml b/man/systemd-inhibit.xml
index c71a95442..de2f26414 100644
--- a/man/systemd-inhibit.xml
+++ b/man/systemd-inhibit.xml
@@ -71,6 +71,10 @@
to avoid system suspends while an optical disc is
being recorded, or similar operations that should not
be interrupted.
+
+ For more information see the Inhibitor
+ Lock Developer Documentation.
@@ -80,7 +84,7 @@
-
+ Prints a short help
@@ -97,24 +101,32 @@
- Takes a colon
- separated list of one or more
+ Takes a colon-separated
+ list of one or more
operations to inhibit:
shutdown,
sleep,
- idle, for
- inhibiting reboot/power-off/halt/kexec,
- suspending/hibernating, resp. the
- automatic idle
- detection.
+ idle,
+ handle-power-key,
+ handle-suspend-key,
+ handle-hibernate-key,
+ handle-lid-switch,
+ for inhibiting
+ reboot/power-off/halt/kexec,
+ suspending/hibernating, the automatic
+ idle detection, or the low-level
+ handling of the power/sleep key and
+ the lid switch, respectively. If omitted,
+ defaults to
+ idle:sleep:shutdown.
- Takes a short human
- readable descriptive string for the
- program taking the lock. If not passed
+ Takes a short,
+ human-readable descriptive string for the
+ program taking the lock. If not passed,
defaults to the command line
string.
@@ -122,8 +134,8 @@
- Takes a short human
- readable descriptive string for the
+ Takes a short,
+ human-readable descriptive string for the
reason for taking the lock. Defaults
to "Unknown reason".
@@ -143,10 +155,14 @@
delay is used, the
lock can only delay the requested
operations for a limited time. If the
- time elapses the lock is ignored and
+ time elapses, the lock is ignored and
the operation executed. The time limit
may be specified in
- systemd-logind.conf5.
+ systemd-logind.conf5. Note
+ that delay is only
+ available for sleep
+ and
+ shutdown.
@@ -156,8 +172,6 @@
inhibition locks instead of acquiring
one.
-
-
@@ -168,6 +182,18 @@
Returns the exit status of the executed program.
+
+ Example
+
+ # systemd-inhibit wodim foobar.iso
+
+ This burns the ISO image
+ foobar.iso on a CD using
+ wodim1,
+ and inhibits system sleeping, shutdown and idle while
+ doing so.
+
+
See Also