chiark / gitweb /
systemctl: allow status with no units
[elogind.git] / man / systemctl.xml
index bf11cc3c71cd9e2fc2e73b3522befdff2a8e4db7..760115acb55444789b12f804fdddaf45d638439c 100644 (file)
                                 manager of the calling user.</para></listitem>
                         </varlistentry>
 
-                        <varlistentry>
-                                <term><option>--order</option></term>
-                                <term><option>--require</option></term>
-
-                                <listitem><para>When used in
-                                conjunction with the
-                                <command>dot</command> command (see
-                                below), selects which dependencies are
-                                shown in the dependency graph. If
-                                <option>--order</option> is passed
-                                only dependencies of type
-                                <varname>After=</varname> or
-                                <varname>Before=</varname> are
-                                shown. If <option>--require</option>
-                                is passed only dependencies of type
-                                <varname>Requires=</varname>,
-                                <varname>RequiresOverridable=</varname>,
-                                <varname>Requisite=</varname>,
-                                <varname>RequisiteOverridable=</varname>,
-                                <varname>Wants=</varname> and
-                                <varname>Conflicts=</varname> are
-                                shown. If neither is passed, shows
-                                dependencies of all these
-                                types.</para></listitem>
-                        </varlistentry>
-
                         <varlistentry>
                                 <term><option>--no-wall</option></term>
 
                         <varlistentry>
                                 <term><command>list-units</command></term>
 
-                                <listitem><para>List known units.</para></listitem>
+                                <listitem><para>List known units (subject to limitations
+                                specified with <option>-t</option>).</para>
+
+                                <para>This is the default command.</para></listitem>
                         </varlistentry>
                         <varlistentry>
                                 <term><command>start [NAME...]</command></term>
 
                                 <listitem><para>Show terse runtime
                                 status information about one or more
-                                units, followed by its most recent log
-                                data from the journal. This function
-                                is intended to generate human-readable
-                                output. If you are looking for
-                                computer-parsable output, use
-                                <command>show</command> instead. If a
-                                PID is passed information about the
-                                unit the process of the PID belongs to
-                                is shown.</para></listitem>
+                                units, followed by most recent log
+                                data from the journal. If no units are
+                                specified, show all units (subject to
+                                limitations specified with
+                                <option>-t</option>). If a PID is
+                                passed show information about the unit
+                                the process belongs to.</para>
+
+                                <para>This function is intended to
+                                generate human-readable output. If you
+                                are looking for computer-parsable
+                                output, use <command>show</command>
+                                instead.</para></listitem>
                         </varlistentry>
                         <varlistentry>
                                 <term><command>show [NAME...|JOB...]</command></term>
                                 be parsed by
                                 applications.</para></listitem>
                         </varlistentry>
-                        <varlistentry>
-                                <term><command>dot</command></term>
-
-                                <listitem><para>Generate textual
-                                dependency graph description in dot
-                                format for further processing with the
-                                GraphViz
-                                <citerefentry><refentrytitle>dot</refentrytitle><manvolnum>1</manvolnum></citerefentry>
-                                tool. Use a command line like
-                                <command>systemctl dot | dot -Tsvg >
-                                systemd.svg</command> to generate a
-                                graphical dependency tree. Unless
-                                <option>--order</option> or
-                                <option>--require</option> is passed
-                                the generated graph will show both
-                                ordering and requirement
-                                dependencies.</para></listitem>
-                        </varlistentry>
                         <varlistentry>
                                 <term><command>list-dependencies [NAME]</command></term>