diff options
author | Lennart Poettering <lennart@poettering.net> | 2018-05-10 11:14:23 -0700 |
---|---|---|
committer | GitHub <noreply@github.com> | 2018-05-10 11:14:23 -0700 |
commit | 81321f51cf7968060a3ad458c199d63a6999f2da (patch) | |
tree | e0b4809142cb2aef722ed4b3ee84e09b82a6ad5e /man/systemd-analyze.xml | |
parent | 41b9d436b2739cbe8bf9482b665d85d59d06bc0e (diff) | |
parent | a826d4f7d01b144df191cf7a6de729b678cdb1d9 (diff) | |
download | systemd-81321f51cf7968060a3ad458c199d63a6999f2da.tar.gz |
Merge pull request #8824 from keszybz/analyze-show-config
systemd-analyze show-config
Diffstat (limited to 'man/systemd-analyze.xml')
-rw-r--r-- | man/systemd-analyze.xml | 41 |
1 files changed, 41 insertions, 0 deletions
diff --git a/man/systemd-analyze.xml b/man/systemd-analyze.xml index 12d54640a9..55751ec107 100644 --- a/man/systemd-analyze.xml +++ b/man/systemd-analyze.xml @@ -81,6 +81,12 @@ <cmdsynopsis> <command>systemd-analyze</command> <arg choice="opt" rep="repeat">OPTIONS</arg> + <arg choice="plain">cat-config</arg> + <arg choice="plain" rep="repeat"><replaceable>NAME</replaceable>|<replaceable>PATH</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis> + <command>systemd-analyze</command> + <arg choice="opt" rep="repeat">OPTIONS</arg> <arg choice="plain">unit-paths</arg> </cmdsynopsis> <cmdsynopsis> @@ -184,6 +190,34 @@ state. Its format is subject to change without notice and should not be parsed by applications.</para> + <para><command>systemd-analyze cat-config</command> is similar + to <command>systemctl cat</command>, but operates on config files. + It will copy the contents of a config file and any drop-ins to standard + output, using the usual systemd set of directories and rules for + precedence. Each argument must be either an absolute path including + the prefix (such as <filename>/etc/systemd/logind.conf</filename> or + <filename>/usr/lib/systemd/logind.conf</filename>), or a name + relative to the prefix (such as <filename>systemd/logind.conf</filename>). + </para> + + <example> + <title>Showing logind configuration</title> + <programlisting>$ systemd-analyze cat-config systemd/logind.conf +# /etc/systemd/logind.conf +# This file is part of systemd. +... +[Login] +NAutoVTs=8 +... + +# /usr/lib/systemd/logind.conf.d/20-test.conf +... some override from another package + +# /etc/systemd/logind.conf.d/50-override.conf +... some adminstrator override + </programlisting> + </example> + <para><command>systemd-analyze unit-paths</command> outputs a list of all directories from which unit files, <filename>.d</filename> overrides, and <filename>.wants</filename>, <filename>.requires</filename> symlinks may be @@ -341,6 +375,13 @@ generators enabled will generally result in some warnings.</para></listitem> </varlistentry> + <varlistentry> + <term><option>--root=<replaceable>PATH</replaceable></option></term> + + <listitem><para>With <command>cat-files</command>, show config files underneath + the specified root path <replaceable>PATH</replaceable>.</para></listitem> + </varlistentry> + <xi:include href="user-system-options.xml" xpointer="host" /> <xi:include href="user-system-options.xml" xpointer="machine" /> |