1SYSTEMD-INHIBIT(1) systemd-inhibit SYSTEMD-INHIBIT(1)
2
6 systemd-inhibit - Execute a program with an inhibition lock taken
7
9 systemd-inhibit [OPTIONS...] [COMMAND] [ARGUMENTS...]
10 systemd-inhibit [OPTIONS...] --list
12
14 systemd-inhibit may be used to execute a program with a shutdown,
15 sleep, or idle inhibitor lock taken. The lock will be acquired before
16 the specified command line is executed and released afterwards.
17 Inhibitor locks may be used to block or delay system sleep and shutdown
19 requests from the user, as well as automatic idle handling of the OS.
20 This is useful to avoid system suspends while an optical disc is being
21 recorded, or similar operations that should not be interrupted.
22 For more information see the Inhibitor Lock Developer Documentation[1].
24
26 The following options are understood:
27 --what=
29 Takes a colon-separated list of one or more operations to inhibit:
30 "shutdown", "sleep", "idle", "handle-power-key",
31 "handle-suspend-key", "handle-hibernate-key", "handle-lid-switch",
32 for inhibiting reboot/power-off/halt/kexec, suspending/hibernating,
33 the automatic idle detection, or the low-level handling of the
34 power/sleep key and the lid switch, respectively. If omitted,
35 defaults to "idle:sleep:shutdown".
36 --who=
38 Takes a short, human-readable descriptive string for the program
39 taking the lock. If not passed, defaults to the command line
40 string.
41 --why=
43 Takes a short, human-readable descriptive string for the reason for
44 taking the lock. Defaults to "Unknown reason".
45 --mode=
47 Takes either "block" or "delay" and describes how the lock is
48 applied. If "block" is used (the default), the lock prohibits any
49 of the requested operations without time limit, and only privileged
50 users may override it. If "delay" is used, the lock can only delay
51 the requested operations for a limited time. If the time elapses,
52 the lock is ignored and the operation executed. The time limit may
53 be specified in logind.conf(5). Note that "delay" is only available
54 for "sleep" and "shutdown".
55 --list
57 Lists all active inhibition locks instead of acquiring one.
58 --no-pager
60 Do not pipe output into a pager.
61 --no-legend
63 Do not print the legend, i.e. column headers and the footer with
64 hints.
65 -h, --help
67 Print a short help text and exit.
68 --version
70 Print a short version string and exit.
71
73 Returns the exit status of the executed program.
74
76 # systemd-inhibit wodim foobar.iso
77 This burns the ISO image foobar.iso on a CD using wodim(1), and
79 inhibits system sleeping, shutdown and idle while doing so.
80
82 $SYSTEMD_LOG_LEVEL
83 The maximum log level of emitted messages (messages with a higher
84 log level, i.e. less important ones, will be suppressed). Either
85 one of (in order of decreasing importance) emerg, alert, crit, err,
86 warning, notice, info, debug, or an integer in the range 0...7. See
87 syslog(3) for more information.
88 $SYSTEMD_LOG_COLOR
90 A boolean. If true, messages written to the tty will be colored
91 according to priority.
92 This setting is only useful when messages are written directly to
94 the terminal, because journalctl(1) and other tools that display
95 logs will color messages based on the log level on their own.
96 $SYSTEMD_LOG_TIME
98 A boolean. If true, log messages will be prefixed with a timestamp.
99 This setting is only useful when messages are written directly to
101 the terminal or a file, because journalctl(1) and other tools that
102 display logs will attach timestamps based on the entry metadata on
103 their own.
104 $SYSTEMD_LOG_LOCATION
106 A boolean. If true, messages will be prefixed with a filename and
107 line number in the source code where the message originates.
108 Note that the log location is often attached as metadata to journal
110 entries anyway. Including it directly in the message text can
111 nevertheless be convenient when debugging programs.
112 $SYSTEMD_LOG_TID
114 A boolean. If true, messages will be prefixed with the current
115 numerical thread ID (TID).
116 Note that the this information is attached as metadata to journal
118 entries anyway. Including it directly in the message text can
119 nevertheless be convenient when debugging programs.
120 $SYSTEMD_LOG_TARGET
122 The destination for log messages. One of console (log to the
123 attached tty), console-prefixed (log to the attached tty but with
124 prefixes encoding the log level and "facility", see syslog(3), kmsg
125 (log to the kernel circular log buffer), journal (log to the
126 journal), journal-or-kmsg (log to the journal if available, and to
127 kmsg otherwise), auto (determine the appropriate log target
128 automatically, the default), null (disable log output).
129 $SYSTEMD_PAGER
131 Pager to use when --no-pager is not given; overrides $PAGER. If
132 neither $SYSTEMD_PAGER nor $PAGER are set, a set of well-known
133 pager implementations are tried in turn, including less(1) and
134 more(1), until one is found. If no pager implementation is
135 discovered no pager is invoked. Setting this environment variable
136 to an empty string or the value "cat" is equivalent to passing
137 --no-pager.
138 $SYSTEMD_LESS
140 Override the options passed to less (by default "FRSXMK").
141 Users might want to change two options in particular:
143 K
145 This option instructs the pager to exit immediately when Ctrl+C
146 is pressed. To allow less to handle Ctrl+C itself to switch
147 back to the pager command prompt, unset this option.
148 If the value of $SYSTEMD_LESS does not include "K", and the
150 pager that is invoked is less, Ctrl+C will be ignored by the
151 executable, and needs to be handled by the pager.
152 X
154 This option instructs the pager to not send termcap
155 initialization and deinitialization strings to the terminal. It
156 is set by default to allow command output to remain visible in
157 the terminal even after the pager exits. Nevertheless, this
158 prevents some pager functionality from working, in particular
159 paged output cannot be scrolled with the mouse.
160 See less(1) for more discussion.
162 $SYSTEMD_LESSCHARSET
164 Override the charset passed to less (by default "utf-8", if the
165 invoking terminal is determined to be UTF-8 compatible).
166 $SYSTEMD_PAGERSECURE
168 Takes a boolean argument. When true, the "secure" mode of the pager
169 is enabled; if false, disabled. If $SYSTEMD_PAGERSECURE is not set
170 at all, secure mode is enabled if the effective UID is not the same
171 as the owner of the login session, see geteuid(2) and
172 sd_pid_get_owner_uid(3). In secure mode, LESSSECURE=1 will be set
173 when invoking the pager, and the pager shall disable commands that
174 open or create new files or start new subprocesses. When
175 $SYSTEMD_PAGERSECURE is not set at all, pagers which are not known
176 to implement secure mode will not be used. (Currently only less(1)
177 implements secure mode.)
178 Note: when commands are invoked with elevated privileges, for
180 example under sudo(8) or pkexec(1), care must be taken to ensure
181 that unintended interactive features are not enabled. "Secure" mode
182 for the pager may be enabled automatically as describe above.
183 Setting SYSTEMD_PAGERSECURE=0 or not removing it from the inherited
184 environment allows the user to invoke arbitrary commands. Note that
185 if the $SYSTEMD_PAGER or $PAGER variables are to be honoured,
186 $SYSTEMD_PAGERSECURE must be set too. It might be reasonable to
187 completely disable the pager using --no-pager instead.
188 $SYSTEMD_COLORS
190 Takes a boolean argument. When true, systemd and related utilities
191 will use colors in their output, otherwise the output will be
192 monochrome. Additionally, the variable can take one of the
193 following special values: "16", "256" to restrict the use of colors
194 to the base 16 or 256 ANSI colors, respectively. This can be
195 specified to override the automatic decision based on $TERM and
196 what the console is connected to.
197 $SYSTEMD_URLIFY
199 The value must be a boolean. Controls whether clickable links
200 should be generated in the output for terminal emulators supporting
201 this. This can be specified to override the decision that systemd
202 makes based on $TERM and other conditions.
203
205 systemd(1), logind.conf(5)
206
208 1. Inhibitor Lock Developer Documentation
209 https://www.freedesktop.org/wiki/Software/systemd/inhibit
210systemd 248 SYSTEMD-INHIBIT(1)