mirror of
https://github.com/systemd/systemd
synced 2024-09-06 08:46:19 +00:00
![Mike Yuan](/assets/img/avatar_default.png)
no-pager-255 was added in #29184, which I reviewed and agreed. However, as #30887 came up, I reconsidered it a bit, and now I actually think that this should be removed. We add new tools that refer to these standard options. During the process, some options are also promoted to be standard ones. I think a more sane practice is to generally keep old tools in the loop, rather than overloading the standard-options with versions.
139 lines
5.2 KiB
XML
139 lines
5.2 KiB
XML
<?xml version="1.0"?>
|
|
<!DOCTYPE variablelist PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
|
|
<!-- SPDX-License-Identifier: LGPL-2.1-or-later -->
|
|
|
|
<variablelist>
|
|
<varlistentry id='help'>
|
|
<term><option>-h</option></term>
|
|
<term><option>--help</option></term>
|
|
|
|
<listitem id='help-text'>
|
|
<para id='help-para'>Print a short help text and exit.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id='version'>
|
|
<term><option>--version</option></term>
|
|
|
|
<listitem id='version-text'>
|
|
<para>Print a short version string and exit.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id='no-pager'>
|
|
<term><option>--no-pager</option></term>
|
|
|
|
<listitem>
|
|
<para>Do not pipe output into a pager.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id='no-ask-password'>
|
|
<term><option>--no-ask-password</option></term>
|
|
|
|
<listitem><para>Do not query the user for authentication for privileged operations.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id='legend'>
|
|
<term><option>--legend=</option><replaceable>BOOL</replaceable></term>
|
|
|
|
<listitem>
|
|
<para>Enable or disable printing of the legend, i.e. column headers and the footer with hints. The
|
|
legend is printed by default, unless disabled with <option>--quiet</option> or similar.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id='no-legend'>
|
|
<term><option>--no-legend</option></term>
|
|
|
|
<listitem>
|
|
<para>Do not print the legend, i.e. column headers and the
|
|
footer with hints.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id='cat-config'>
|
|
<term><option>--cat-config</option></term>
|
|
|
|
<listitem>
|
|
<para>Copy the contents of config files to standard output.
|
|
Before each file, the filename is printed as a comment.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id='tldr'>
|
|
<term><option>--tldr</option></term>
|
|
|
|
<listitem>
|
|
<para>Copy the contents of config files to standard output. Only the "interesting" parts of the
|
|
configuration files are printed, comments and empty lines are skipped. Before each file, the filename
|
|
is printed as a comment.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id='json'>
|
|
<term><option>--json=</option><replaceable>MODE</replaceable></term>
|
|
|
|
<listitem><para>Shows output formatted as JSON. Expects one of <literal>short</literal> (for the
|
|
shortest possible output without any redundant whitespace or line breaks), <literal>pretty</literal>
|
|
(for a pretty version of the same, with indentation and line breaks) or <literal>off</literal> (to turn
|
|
off JSON output, the default).</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id='j'>
|
|
<term><option>-j</option></term>
|
|
|
|
<listitem><para>Equivalent to <option>--json=pretty</option> if running on a terminal, and
|
|
<option>--json=short</option> otherwise.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id='signal'>
|
|
<term><option>-s</option></term>
|
|
<term><option>--signal=</option></term>
|
|
|
|
<listitem>
|
|
<para>When used with <command>kill</command>, choose which signal to send to selected processes. Must
|
|
be one of the well-known signal specifiers such as <constant>SIGTERM</constant>,
|
|
<constant>SIGINT</constant> or <constant>SIGSTOP</constant>. If omitted, defaults to
|
|
<option>SIGTERM</option>.</para>
|
|
|
|
<para>The special value <literal>help</literal> will list the known values and the program will exit
|
|
immediately, and the special value <literal>list</literal> will list known values along with the
|
|
numerical signal numbers and the program will exit immediately.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id='image-policy-open'>
|
|
<term><option>--image-policy=<replaceable>policy</replaceable></option></term>
|
|
|
|
<listitem><para>Takes an image policy string as argument, as per
|
|
<citerefentry><refentrytitle>systemd.image-policy</refentrytitle><manvolnum>7</manvolnum></citerefentry>. The
|
|
policy is enforced when operating on the disk image specified via <option>--image=</option>, see
|
|
above. If not specified defaults to the <literal>*</literal> policy, i.e. all recognized file systems
|
|
in the image are used.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id='esp-path'>
|
|
<term><option>--esp-path=</option></term>
|
|
|
|
<listitem>
|
|
<para>Path to the EFI System Partition (ESP). If not specified, <filename>/efi/</filename>,
|
|
<filename>/boot/</filename>, and <filename>/boot/efi/</filename> are checked in turn. It is
|
|
recommended to mount the ESP to <filename>/efi/</filename>, if possible.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id='boot-path'>
|
|
<term><option>--boot-path=</option></term>
|
|
|
|
<listitem>
|
|
<para>Path to the Extended Boot Loader partition, as defined in the
|
|
<ulink url="https://uapi-group.org/specifications/specs/boot_loader_specification">Boot Loader Specification</ulink>.
|
|
If not specified, <filename>/boot/</filename> is checked. It is recommended to mount the Extended Boot
|
|
Loader partition to <filename>/boot/</filename>, if possible.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|