diff options
Diffstat (limited to 'man/systemd-analyze.xml')
| -rw-r--r-- | man/systemd-analyze.xml | 78 |
1 files changed, 45 insertions, 33 deletions
diff --git a/man/systemd-analyze.xml b/man/systemd-analyze.xml index 97a9b2cca7..7aa10fc68e 100644 --- a/man/systemd-analyze.xml +++ b/man/systemd-analyze.xml @@ -4,23 +4,6 @@ <!-- SPDX-License-Identifier: LGPL-2.1+ - - This file is part of systemd. - - Copyright 2012 Lennart Poettering - - systemd is free software; you can redistribute it and/or modify it - under the terms of the GNU Lesser General Public License as published by - the Free Software Foundation; either version 2.1 of the License, or - (at your option) any later version. - - systemd is distributed in the hope that it will be useful, but - WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - Lesser General Public License for more details. - - You should have received a copy of the GNU Lesser General Public License - along with systemd; If not, see <http://www.gnu.org/licenses/>. --> <refentry id="systemd-analyze" @@ -29,21 +12,6 @@ <refentryinfo> <title>systemd-analyze</title> <productname>systemd</productname> - - <authorgroup> - <author> - <contrib>Developer</contrib> - <firstname>Lennart</firstname> - <surname>Poettering</surname> - <email>lennart@poettering.net</email> - </author> - <author> - <contrib>Developer</contrib> - <firstname>Harald</firstname> - <surname>Hoyer</surname> - <email>harald@redhat.com</email> - </author> - </authorgroup> </refentryinfo> <refmeta> @@ -94,6 +62,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> @@ -157,7 +131,11 @@ This information may be used to optimize boot-up times. Note that the output might be misleading as the initialization of one service might be slow simply because it waits for the - initialization of another service to complete.</para> + initialization of another service to complete. + Also note: <command>systemd-analyze blame</command> doesn't display + results for services with <varname>Type=simple</varname>, + because systemd considers such services to be started immediately, + hence no measurement of the initialization delays can be done.</para> <para><command>systemd-analyze critical-chain [<replaceable>UNIT…</replaceable>]</command> prints a tree of @@ -193,6 +171,33 @@ 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 +... +[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 administrator 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 @@ -350,6 +355,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" /> |