summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2022-05-31 10:30:09 +0200
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2022-06-01 09:23:55 +0200
commit5b69a7c540828098cd353a8b7e5207750e02347b (patch)
treeadde527f41555a99e9ccae31b00783d11c8a713c /man
parent1cc11a0951037054e14c663946ed9091b61f3cb6 (diff)
downloadsystemd-5b69a7c540828098cd353a8b7e5207750e02347b.tar.gz
man/systemctl: improve grammar in description of --check-inhibitors
Diffstat (limited to 'man')
-rw-r--r--man/systemctl.xml30
1 files changed, 14 insertions, 16 deletions
diff --git a/man/systemctl.xml b/man/systemctl.xml
index 63ea80a453..6b2798ecde 100644
--- a/man/systemctl.xml
+++ b/man/systemctl.xml
@@ -1924,23 +1924,21 @@ Jan 12 10:46:45 example.com bluetoothd[8900]: gatt-time-server: Input/output err
<term><option>--check-inhibitors=</option></term>
<listitem>
- <para>When system shutdown or sleep state is request, this option controls how to deal with
- inhibitor locks. It takes one of <literal>auto</literal>, <literal>yes</literal> or
+ <para>When system shutdown or sleep state is requested, this option controls checking of inhibitor
+ locks. It takes one of <literal>auto</literal>, <literal>yes</literal> or
<literal>no</literal>. Defaults to <literal>auto</literal>, which will behave like
- <literal>yes</literal> for interactive invocations (i.e. from a TTY) and <literal>no</literal>
- for non-interactive invocations.
- <literal>yes</literal> will let the request respect inhibitor locks.
- <literal>no</literal> will let the request ignore inhibitor locks.
- </para>
- <para>Applications can establish inhibitor locks to avoid that certain important operations
- (such as CD burning or suchlike) are interrupted by system shutdown or a sleep state. Any user may
- take these locks and privileged users may override these locks.
- If any locks are taken, shutdown and sleep state requests will normally fail (unless privileged)
- and a list of active locks is printed.
- However, if <literal>no</literal> is specified or <literal>auto</literal> is specified on a
- non-interactive requests, the established locks are ignored and not shown, and the operation
- attempted anyway, possibly requiring additional privileges.
- May be overridden by <option>--force</option>.</para>
+ <literal>yes</literal> for interactive invocations (i.e. from a TTY) and <literal>no</literal> for
+ non-interactive invocations. <literal>yes</literal> lets the request respect inhibitor locks.
+ <literal>no</literal> lets the request ignore inhibitor locks.</para>
+
+ <para>Applications can establish inhibitor locks to prevent certain important operations (such as
+ CD burning) from being interrupted by system shutdown or sleep. Any user may take these locks and
+ privileged users may override these locks. If any locks are taken, shutdown and sleep state
+ requests will normally fail (unless privileged). However, if <literal>no</literal> is specified or
+ <literal>auto</literal> is specified on a non-interactive requests, the operation will be
+ attempted. If locks are present, the operation may require additional privileges.</para>
+
+ <para>Option <option>--force</option> provides another way to override inhibitors.</para>
</listitem>
</varlistentry>