man: bring systemctl man page and --help text into the same order
This commit is contained in:
parent
17cd091332
commit
b619ec8f83
|
@ -386,7 +386,6 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
|
||||||
querying the user for authentication for privileged
|
querying the user for authentication for privileged
|
||||||
operations.</para>
|
operations.</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
|
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
|
@ -992,6 +991,56 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term><command>reenable <replaceable>NAME</replaceable>...</command></term>
|
||||||
|
|
||||||
|
<listitem>
|
||||||
|
<para>Reenable one or more unit files, as specified on the
|
||||||
|
command line. This is a combination of
|
||||||
|
<command>disable</command> and <command>enable</command> and
|
||||||
|
is useful to reset the symlinks a unit is enabled with to
|
||||||
|
the defaults configured in the <literal>[Install]</literal>
|
||||||
|
section of the unit file.</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term><command>preset <replaceable>NAME</replaceable>...</command></term>
|
||||||
|
|
||||||
|
<listitem>
|
||||||
|
<para>Reset one or more unit files, as specified on the
|
||||||
|
command line, to the defaults configured in the preset
|
||||||
|
policy files. This has the same effect as
|
||||||
|
<command>disable</command> or <command>enable</command>,
|
||||||
|
depending how the unit is listed in the preset files.</para>
|
||||||
|
|
||||||
|
<para>Use <option>--preset-mode=</option> to control
|
||||||
|
whether units shall be enabled and disabled, or only
|
||||||
|
enabled, or only disabled.</para>
|
||||||
|
|
||||||
|
<para>For more information on the preset policy format,
|
||||||
|
see
|
||||||
|
<citerefentry><refentrytitle>systemd.preset</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
|
||||||
|
For more information on the concept of presets, please
|
||||||
|
consult the <ulink
|
||||||
|
url="http://freedesktop.org/wiki/Software/systemd/Preset">Preset</ulink>
|
||||||
|
document.</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term><command>preset-all</command></term>
|
||||||
|
|
||||||
|
<listitem>
|
||||||
|
<para>Resets all installed unit files to the defaults
|
||||||
|
configured in the preset policy file (see above).</para>
|
||||||
|
|
||||||
|
<para>Use <option>--preset-mode=</option> to control
|
||||||
|
whether units shall be enabled and disabled, or only
|
||||||
|
enabled, or only disabled.</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><command>is-enabled <replaceable>NAME</replaceable>...</command></term>
|
<term><command>is-enabled <replaceable>NAME</replaceable>...</command></term>
|
||||||
|
|
||||||
|
@ -1063,56 +1112,6 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
|
||||||
<term><command>reenable <replaceable>NAME</replaceable>...</command></term>
|
|
||||||
|
|
||||||
<listitem>
|
|
||||||
<para>Reenable one or more unit files, as specified on the
|
|
||||||
command line. This is a combination of
|
|
||||||
<command>disable</command> and <command>enable</command> and
|
|
||||||
is useful to reset the symlinks a unit is enabled with to
|
|
||||||
the defaults configured in the <literal>[Install]</literal>
|
|
||||||
section of the unit file.</para>
|
|
||||||
</listitem>
|
|
||||||
</varlistentry>
|
|
||||||
|
|
||||||
<varlistentry>
|
|
||||||
<term><command>preset <replaceable>NAME</replaceable>...</command></term>
|
|
||||||
|
|
||||||
<listitem>
|
|
||||||
<para>Reset one or more unit files, as specified on the
|
|
||||||
command line, to the defaults configured in the preset
|
|
||||||
policy files. This has the same effect as
|
|
||||||
<command>disable</command> or <command>enable</command>,
|
|
||||||
depending how the unit is listed in the preset files.</para>
|
|
||||||
|
|
||||||
<para>Use <option>--preset-mode=</option> to control
|
|
||||||
whether units shall be enabled and disabled, or only
|
|
||||||
enabled, or only disabled.</para>
|
|
||||||
|
|
||||||
<para>For more information on the preset policy format,
|
|
||||||
see
|
|
||||||
<citerefentry><refentrytitle>systemd.preset</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
|
|
||||||
For more information on the concept of presets, please
|
|
||||||
consult the <ulink
|
|
||||||
url="http://freedesktop.org/wiki/Software/systemd/Preset">Preset</ulink>
|
|
||||||
document.</para>
|
|
||||||
</listitem>
|
|
||||||
</varlistentry>
|
|
||||||
|
|
||||||
<varlistentry>
|
|
||||||
<term><command>preset-all</command></term>
|
|
||||||
|
|
||||||
<listitem>
|
|
||||||
<para>Resets all installed unit files to the defaults
|
|
||||||
configured in the preset policy file (see above).</para>
|
|
||||||
|
|
||||||
<para>Use <option>--preset-mode=</option> to control
|
|
||||||
whether units shall be enabled and disabled, or only
|
|
||||||
enabled, or only disabled.</para>
|
|
||||||
</listitem>
|
|
||||||
</varlistentry>
|
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><command>mask <replaceable>NAME</replaceable>...</command></term>
|
<term><command>mask <replaceable>NAME</replaceable>...</command></term>
|
||||||
|
|
||||||
|
@ -1139,6 +1138,20 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term><command>link <replaceable>FILENAME</replaceable>...</command></term>
|
||||||
|
|
||||||
|
<listitem>
|
||||||
|
<para>Link a unit file that is not in the unit file search
|
||||||
|
paths into the unit file search path. This requires an
|
||||||
|
absolute path to a unit file. The effect of this can be
|
||||||
|
undone with <command>disable</command>. The effect of this
|
||||||
|
command is that a unit file is available for
|
||||||
|
<command>start</command> and other commands although it
|
||||||
|
is not installed directly in the unit search path.</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><command>add-wants <replaceable>TARGET</replaceable>
|
<term><command>add-wants <replaceable>TARGET</replaceable>
|
||||||
<replaceable>NAME</replaceable>...</command></term>
|
<replaceable>NAME</replaceable>...</command></term>
|
||||||
|
@ -1158,38 +1171,6 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
|
||||||
<term><command>link <replaceable>FILENAME</replaceable>...</command></term>
|
|
||||||
|
|
||||||
<listitem>
|
|
||||||
<para>Link a unit file that is not in the unit file search
|
|
||||||
paths into the unit file search path. This requires an
|
|
||||||
absolute path to a unit file. The effect of this can be
|
|
||||||
undone with <command>disable</command>. The effect of this
|
|
||||||
command is that a unit file is available for
|
|
||||||
<command>start</command> and other commands although it
|
|
||||||
is not installed directly in the unit search path.</para>
|
|
||||||
</listitem>
|
|
||||||
</varlistentry>
|
|
||||||
|
|
||||||
<varlistentry>
|
|
||||||
<term><command>get-default</command></term>
|
|
||||||
|
|
||||||
<listitem>
|
|
||||||
<para>Get the default target specified
|
|
||||||
via <filename>default.target</filename> link.</para>
|
|
||||||
</listitem>
|
|
||||||
</varlistentry>
|
|
||||||
|
|
||||||
<varlistentry>
|
|
||||||
<term><command>set-default <replaceable>NAME</replaceable></command></term>
|
|
||||||
|
|
||||||
<listitem>
|
|
||||||
<para>Set the default target to boot into. Command links
|
|
||||||
<filename>default.target</filename> to the given unit.</para>
|
|
||||||
</listitem>
|
|
||||||
</varlistentry>
|
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><command>edit <replaceable>NAME</replaceable>...</command></term>
|
<term><command>edit <replaceable>NAME</replaceable>...</command></term>
|
||||||
|
|
||||||
|
@ -1226,6 +1207,27 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
|
||||||
<filename>/run</filename>.</para>
|
<filename>/run</filename>.</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term><command>get-default</command></term>
|
||||||
|
|
||||||
|
<listitem>
|
||||||
|
<para>Return the default target to boot into. This returns
|
||||||
|
the target unit name <filename>default.target</filename>
|
||||||
|
is aliased (symlinked) to.</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term><command>set-default <replaceable>NAME</replaceable></command></term>
|
||||||
|
|
||||||
|
<listitem>
|
||||||
|
<para>Set the default target to boot into. This sets
|
||||||
|
(symlinks) the <filename>default.target</filename> alias
|
||||||
|
to the given target unit.</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
</variablelist>
|
</variablelist>
|
||||||
</refsect2>
|
</refsect2>
|
||||||
|
|
||||||
|
@ -1547,6 +1549,7 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
|
||||||
<quote>firmware over the air</quote> update.</para>
|
<quote>firmware over the air</quote> update.</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><command>kexec</command></term>
|
<term><command>kexec</command></term>
|
||||||
|
|
||||||
|
@ -1560,6 +1563,7 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
|
||||||
immediately followed by the reboot.</para>
|
immediately followed by the reboot.</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><command>exit</command></term>
|
<term><command>exit</command></term>
|
||||||
|
|
||||||
|
@ -1569,35 +1573,8 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
|
||||||
with the <option>--user</option> option) and will fail
|
with the <option>--user</option> option) and will fail
|
||||||
otherwise.</para>
|
otherwise.</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
|
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
<varlistentry>
|
|
||||||
<term><command>suspend</command></term>
|
|
||||||
|
|
||||||
<listitem>
|
|
||||||
<para>Suspend the system. This will trigger activation of
|
|
||||||
the special <filename>suspend.target</filename> target.
|
|
||||||
</para>
|
|
||||||
</listitem>
|
|
||||||
</varlistentry>
|
|
||||||
<varlistentry>
|
|
||||||
<term><command>hibernate</command></term>
|
|
||||||
|
|
||||||
<listitem>
|
|
||||||
<para>Hibernate the system. This will trigger activation of
|
|
||||||
the special <filename>hibernate.target</filename> target.
|
|
||||||
</para>
|
|
||||||
</listitem>
|
|
||||||
</varlistentry>
|
|
||||||
<varlistentry>
|
|
||||||
<term><command>hybrid-sleep</command></term>
|
|
||||||
|
|
||||||
<listitem>
|
|
||||||
<para>Hibernate and suspend the system. This will trigger
|
|
||||||
activation of the special
|
|
||||||
<filename>hybrid-sleep.target</filename> target.</para>
|
|
||||||
</listitem>
|
|
||||||
</varlistentry>
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><command>switch-root <replaceable>ROOT</replaceable> <optional><replaceable>INIT</replaceable></optional></command></term>
|
<term><command>switch-root <replaceable>ROOT</replaceable> <optional><replaceable>INIT</replaceable></optional></command></term>
|
||||||
|
|
||||||
|
@ -1618,6 +1595,36 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
|
||||||
involved in the initrd boot.</para>
|
involved in the initrd boot.</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term><command>suspend</command></term>
|
||||||
|
|
||||||
|
<listitem>
|
||||||
|
<para>Suspend the system. This will trigger activation of
|
||||||
|
the special <filename>suspend.target</filename> target.
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term><command>hibernate</command></term>
|
||||||
|
|
||||||
|
<listitem>
|
||||||
|
<para>Hibernate the system. This will trigger activation of
|
||||||
|
the special <filename>hibernate.target</filename> target.
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry>
|
||||||
|
<term><command>hybrid-sleep</command></term>
|
||||||
|
|
||||||
|
<listitem>
|
||||||
|
<para>Hibernate and suspend the system. This will trigger
|
||||||
|
activation of the special
|
||||||
|
<filename>hybrid-sleep.target</filename> target.</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
</variablelist>
|
</variablelist>
|
||||||
</refsect2>
|
</refsect2>
|
||||||
|
|
||||||
|
|
|
@ -6075,7 +6075,7 @@ static void systemctl_help(void) {
|
||||||
" based on preset configuration\n"
|
" based on preset configuration\n"
|
||||||
" preset-all Enable/disable all unit files based on\n"
|
" preset-all Enable/disable all unit files based on\n"
|
||||||
" preset configuration\n"
|
" preset configuration\n"
|
||||||
" is-enabled NAME... Check whether unit files are enabled\n\n"
|
" is-enabled NAME... Check whether unit files are enabled\n"
|
||||||
" mask NAME... Mask one or more units\n"
|
" mask NAME... Mask one or more units\n"
|
||||||
" unmask NAME... Unmask one or more units\n"
|
" unmask NAME... Unmask one or more units\n"
|
||||||
" link PATH... Link one or more units files into\n"
|
" link PATH... Link one or more units files into\n"
|
||||||
|
@ -6084,10 +6084,9 @@ static void systemctl_help(void) {
|
||||||
" on specified one or more units\n"
|
" on specified one or more units\n"
|
||||||
" add-requires TARGET NAME... Add 'Requires' dependency for the target\n"
|
" add-requires TARGET NAME... Add 'Requires' dependency for the target\n"
|
||||||
" on specified one or more units\n"
|
" on specified one or more units\n"
|
||||||
" get-default Get the name of the default target\n"
|
|
||||||
" set-default NAME Set the default target\n"
|
|
||||||
" edit NAME... Edit one or more unit files\n"
|
" edit NAME... Edit one or more unit files\n"
|
||||||
"\n"
|
" get-default Get the name of the default target\n"
|
||||||
|
" set-default NAME Set the default target\n\n"
|
||||||
"Machine Commands:\n"
|
"Machine Commands:\n"
|
||||||
" list-machines [PATTERN...] List local containers and host\n\n"
|
" list-machines [PATTERN...] List local containers and host\n\n"
|
||||||
"Job Commands:\n"
|
"Job Commands:\n"
|
||||||
|
|
Loading…
Reference in a new issue