summaryrefslogtreecommitdiff
path: root/man/systemd-analyze.xml
diff options
context:
space:
mode:
authorFranck Bui <fbui@suse.com>2022-09-13 16:13:16 +0200
committerYu Watanabe <watanabe.yu+github@gmail.com>2022-10-13 07:47:42 +0900
commitd1d8786c5b4493cc0f9836b1976f2cd41bfb461c (patch)
treedf19253c23a7db5a219e03d6abf5cc0501632fbb /man/systemd-analyze.xml
parent17f6406bf2f3e3bdaf51fd567871876da237ce20 (diff)
downloadsystemd-d1d8786c5b4493cc0f9836b1976f2cd41bfb461c.tar.gz
analyze: extend the dump command to accept patterns
The new function DumpPatterns() can be used to limit (drastically) the size of the data returned by PID1. Hence the optimization of serializing data into a file descriptor should be less relevant than having the possibility to limit the data when communicating with the service manager remotely. NB: when passing patterns, the dump command omits the version of the manager as well as the features and the timestamps.
Diffstat (limited to 'man/systemd-analyze.xml')
-rw-r--r--man/systemd-analyze.xml9
1 files changed, 6 insertions, 3 deletions
diff --git a/man/systemd-analyze.xml b/man/systemd-analyze.xml
index 13b881cfc7..cce08fa121 100644
--- a/man/systemd-analyze.xml
+++ b/man/systemd-analyze.xml
@@ -43,6 +43,7 @@
<command>systemd-analyze</command>
<arg choice="opt" rep="repeat">OPTIONS</arg>
<arg choice="plain">dump</arg>
+ <arg choice="opt" rep="repeat"><replaceable>PATTERN</replaceable></arg>
</cmdsynopsis>
<cmdsynopsis>
@@ -243,10 +244,12 @@ multi-user.target @47.820s
</refsect2>
<refsect2>
- <title><command>systemd-analyze dump</command></title>
+ <title><command>systemd-analyze dump [<replaceable>pattern</replaceable>…]</command></title>
- <para>This command outputs a (usually very long) human-readable serialization of the complete server
- state. Its format is subject to change without notice and should not be parsed by applications.</para>
+ <para>Without any parameter, this command outputs a (usually very long) human-readable serialization of
+ the complete service manager state. Optional glob pattern may be specified, causing the output to be
+ limited to units whose names match one of the patterns. The output format is subject to change without
+ notice and should not be parsed by applications.</para>
<example>
<title>Show the internal state of user manager</title>