shutdown: pivot_root to a tmpfs directory to properly umount root

[elogind.git] / man / systemctl.xml

diff --git a/man/systemctl.xml b/man/systemctl.xml
index 6b05e95defcc12747a4cc4c7f1d8972d693f5372..a3e0a307a81f60ec4c011af4b7198649c3fc51d5 100644 (file)
--- a/man/systemctl.xml
+++ b/man/systemctl.xml
@@ -126,6 +126,15 @@
                                 they are set or not.</para></listitem>
                         </varlistentry>
 
                                 they are set or not.</para></listitem>
                         </varlistentry>
 

+                        <varlistentry>
+                                <term><option>--failed</option></term>
+
+                                <listitem><para>When listing units,
+                                show only failed units. Do not confuse
+                                with
+                                <option>--fail</option>.</para></listitem>
+                        </varlistentry>
+

                         <varlistentry>
                                 <term><option>--full</option></term>
 
                         <varlistentry>
                                 <term><option>--full</option></term>
 


@@ -144,7 +153,24 @@
                                 unfinished job, fail the command. If
                                 this is not specified the requested
                                 operation will replace the pending job,
                                 unfinished job, fail the command. If
                                 this is not specified the requested
                                 operation will replace the pending job,

-                                if necessary.</para></listitem>
+                                if necessary. Do not confuse
+                                with
+                                <option>--failed</option>.</para></listitem>
+                        </varlistentry>
+
+                        <varlistentry>
+                                <term><option>--ignore-dependencies</option></term>
+
+                                <listitem><para>When enqueuing a new
+                                job ignore all its dependencies and
+                                execute it immediately. If passed no
+                                required units of the unit passed will
+                                be pulled in, and no ordering
+                                dependencies will be honoured. This is
+                                mostly a debugging and rescue tool for
+                                the administrator and should not be
+                                used by
+                                applications.</para></listitem>

                         </varlistentry>
 
                         <varlistentry>
                         </varlistentry>
 
                         <varlistentry>


@@ -170,6 +196,13 @@
                                 argument it is only verified and
                                 enqueued.</para></listitem> </varlistentry>
 
                                 argument it is only verified and
                                 enqueued.</para></listitem> </varlistentry>
 

+                        <varlistentry>
+                                <term><option>--no-pager</option></term>
+
+                               <listitem><para>Do not pipe output into a
+                               pager.</para></listitem>
+                       </varlistentry>
+

                         <varlistentry>
                                 <term><option>--system</option></term>
 
                         <varlistentry>
                                 <term><option>--system</option></term>
 


@@ -271,13 +304,11 @@
                                 <command>kill</command>, choose the
                                 mode how to kill the selected
                                 processes. Must be one of
                                 <command>kill</command>, choose the
                                 mode how to kill the selected
                                 processes. Must be one of

-                                <option>control-group</option>,
-                                <option>process-group</option> or
+                                <option>control-group</option> or

                                 <option>process</option> to select
                                 whether to kill the entire control
                                 <option>process</option> to select
                                 whether to kill the entire control

-                                group, the process group or only the
-                                selected process itself. If omitted
-                                defaults to
+                                group or only the selected process
+                                itself. If omitted defaults to

                                 <option>control-group</option> if
                                 <option>--kill-who=all</option> is
                                 set, or <option>process</option>
                                 <option>control-group</option> if
                                 <option>--kill-who=all</option> is
                                 set, or <option>process</option>


@@ -349,6 +380,38 @@
                                 file that shall be
                                 disabled.</para></listitem>
                         </varlistentry>
                                 file that shall be
                                 disabled.</para></listitem>
                         </varlistentry>

+
+                        <varlistentry>
+                                <term><option>--root=</option></term>
+
+                                <listitem><para>When used with
+                               <command>enable</command>/
+                               <command>disable</command>/
+                               <command>is-enabled</command>,
+                               use alternative root path for systemd
+                               install.</para></listitem>
+                        </varlistentry>
+
+                        <varlistentry>
+                                <term><option>-H</option></term>
+                                <term><option>--host</option></term>
+
+                                <listitem><para>Execute operation
+                                remotely. Specify a hostname, or
+                                username and hostname separated by @,
+                                to connect to. This will use SSH to
+                                talk to the remote systemd
+                                instance.</para></listitem>
+                        </varlistentry>
+
+                        <varlistentry>
+                                <term><option>-P</option></term>
+                                <term><option>--privileged</option></term>
+
+                                <listitem><para>Acquire privileges via
+                                PolicyKit before executing the
+                                operation.</para></listitem>
+                        </varlistentry>

                 </variablelist>
 
                 <para>The following commands are understood:</para>
                 </variablelist>
 
                 <para>The following commands are understood:</para>


@@ -414,9 +477,9 @@
 
                                 <listitem><para>Restart one or more
                                 units specified on the command
 
                                 <listitem><para>Restart one or more
                                 units specified on the command

-                                line. If the units are not running yet
-                                the operation will
-                                fail. Note that for compatibility
+                                line if the units are running. Do
+                                nothing if units are not running.
+                                Note that for compatibility

                                 with Red Hat init scripts
                                 <command>condrestart</command> is
                                 equivalent to this command.</para></listitem>
                                 with Red Hat init scripts
                                 <command>condrestart</command> is
                                 equivalent to this command.</para></listitem>


@@ -435,12 +498,13 @@
 
                                 <listitem><para>Reload one or more
                                 units if they support it. If not,
 
                                 <listitem><para>Reload one or more
                                 units if they support it. If not,

-                                restart them instead. If the units
-                                are not running yet the operation
-                                will fail. Note that for
-                                compatibility with SysV init scripts
+                                restart them instead. Do nothing if
+                                the units are not running. Note that
+                                for compatibility with SysV init
+                                scripts

                                 <command>force-reload</command> is
                                 <command>force-reload</command> is

-                                equivalent to this command.</para></listitem>
+                                equivalent to this
+                                command.</para></listitem>

                         </varlistentry>
                         <varlistentry>
                                 <term><command>isolate [NAME]</command></term>
                         </varlistentry>
                         <varlistentry>
                                 <term><command>isolate [NAME]</command></term>


@@ -968,6 +1032,22 @@
                 code otherwise.</para>
         </refsect1>
 
                 code otherwise.</para>
         </refsect1>
 

+        <refsect1>
+                <title>Environment</title>
+
+                <variablelist>
+                        <varlistentry>
+                                <term><varname>$SYSTEMD_PAGER</varname></term>
+                                <listitem><para>Pager to use when
+                                <option>--no-pager</option> is not given;
+                                overrides <varname>$PAGER</varname>.  Setting
+                                this to an empty string or the value
+                                <literal>cat</literal> is equivalent to passing
+                                <option>--no-pager</option>.</para></listitem>
+                        </varlistentry>
+                </variablelist>
+        </refsect1>
+

         <refsect1>
                 <title>See Also</title>
                 <para>
         <refsect1>
                 <title>See Also</title>
                 <para>