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, console log messages will be prefixed with a
99 timestamp.
100 This setting is only useful when messages are written directly to
102 the terminal or a file, because journalctl(1) and other tools that
103 display logs will attach timestamps based on the entry metadata on
104 their own.
105 $SYSTEMD_LOG_LOCATION
107 A boolean. If true, messages will be prefixed with a filename and
108 line number in the source code where the message originates.
109 Note that the log location is often attached as metadata to journal
111 entries anyway. Including it directly in the message text can
112 nevertheless be convenient when debugging programs.
113 $SYSTEMD_LOG_TID
115 A boolean. If true, messages will be prefixed with the current
116 numerical thread ID (TID).
117 Note that the this information is attached as metadata to journal
119 entries anyway. Including it directly in the message text can
120 nevertheless be convenient when debugging programs.
121 $SYSTEMD_LOG_TARGET
123 The destination for log messages. One of console (log to the
124 attached tty), console-prefixed (log to the attached tty but with
125 prefixes encoding the log level and "facility", see syslog(3), kmsg
126 (log to the kernel circular log buffer), journal (log to the
127 journal), journal-or-kmsg (log to the journal if available, and to
128 kmsg otherwise), auto (determine the appropriate log target
129 automatically, the default), null (disable log output).
130 $SYSTEMD_PAGER
132 Pager to use when --no-pager is not given; overrides $PAGER. If
133 neither $SYSTEMD_PAGER nor $PAGER are set, a set of well-known
134 pager implementations are tried in turn, including less(1) and
135 more(1), until one is found. If no pager implementation is
136 discovered no pager is invoked. Setting this environment variable
137 to an empty string or the value "cat" is equivalent to passing
138 --no-pager.
139 Note: if $SYSTEMD_PAGERSECURE is not set, $SYSTEMD_PAGER (as well
141 as $PAGER) will be silently ignored.
142 $SYSTEMD_LESS
144 Override the options passed to less (by default "FRSXMK").
145 Users might want to change two options in particular:
147 K
149 This option instructs the pager to exit immediately when Ctrl+C
150 is pressed. To allow less to handle Ctrl+C itself to switch
151 back to the pager command prompt, unset this option.
152 If the value of $SYSTEMD_LESS does not include "K", and the
154 pager that is invoked is less, Ctrl+C will be ignored by the
155 executable, and needs to be handled by the pager.
156 X
158 This option instructs the pager to not send termcap
159 initialization and deinitialization strings to the terminal. It
160 is set by default to allow command output to remain visible in
161 the terminal even after the pager exits. Nevertheless, this
162 prevents some pager functionality from working, in particular
163 paged output cannot be scrolled with the mouse.
164 See less(1) for more discussion.
166 $SYSTEMD_LESSCHARSET
168 Override the charset passed to less (by default "utf-8", if the
169 invoking terminal is determined to be UTF-8 compatible).
170 $SYSTEMD_PAGERSECURE
172 Takes a boolean argument. When true, the "secure" mode of the pager
173 is enabled; if false, disabled. If $SYSTEMD_PAGERSECURE is not set
174 at all, secure mode is enabled if the effective UID is not the same
175 as the owner of the login session, see geteuid(2) and
176 sd_pid_get_owner_uid(3). In secure mode, LESSSECURE=1 will be set
177 when invoking the pager, and the pager shall disable commands that
178 open or create new files or start new subprocesses. When
179 $SYSTEMD_PAGERSECURE is not set at all, pagers which are not known
180 to implement secure mode will not be used. (Currently only less(1)
181 implements secure mode.)
182 Note: when commands are invoked with elevated privileges, for
184 example under sudo(8) or pkexec(1), care must be taken to ensure
185 that unintended interactive features are not enabled. "Secure" mode
186 for the pager may be enabled automatically as describe above.
187 Setting SYSTEMD_PAGERSECURE=0 or not removing it from the inherited
188 environment allows the user to invoke arbitrary commands. Note that
189 if the $SYSTEMD_PAGER or $PAGER variables are to be honoured,
190 $SYSTEMD_PAGERSECURE must be set too. It might be reasonable to
191 completely disable the pager using --no-pager instead.
192 $SYSTEMD_COLORS
194 Takes a boolean argument. When true, systemd and related utilities
195 will use colors in their output, otherwise the output will be
196 monochrome. Additionally, the variable can take one of the
197 following special values: "16", "256" to restrict the use of colors
198 to the base 16 or 256 ANSI colors, respectively. This can be
199 specified to override the automatic decision based on $TERM and
200 what the console is connected to.
201 $SYSTEMD_URLIFY
203 The value must be a boolean. Controls whether clickable links
204 should be generated in the output for terminal emulators supporting
205 this. This can be specified to override the decision that systemd
206 makes based on $TERM and other conditions.
207
209 systemd(1), logind.conf(5)
210
212 1. Inhibitor Lock Developer Documentation
213 https://www.freedesktop.org/wiki/Software/systemd/inhibit
214systemd 251 SYSTEMD-INHIBIT(1)