diff options
author | Franck Bui <fbui@suse.com> | 2022-09-13 16:13:16 +0200 |
---|---|---|
committer | Yu Watanabe <watanabe.yu+github@gmail.com> | 2022-10-13 07:47:42 +0900 |
commit | d1d8786c5b4493cc0f9836b1976f2cd41bfb461c (patch) | |
tree | df19253c23a7db5a219e03d6abf5cc0501632fbb /man/org.freedesktop.systemd1.xml | |
parent | 17f6406bf2f3e3bdaf51fd567871876da237ce20 (diff) | |
download | systemd-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/org.freedesktop.systemd1.xml')
-rw-r--r-- | man/org.freedesktop.systemd1.xml | 8 |
1 files changed, 7 insertions, 1 deletions
diff --git a/man/org.freedesktop.systemd1.xml b/man/org.freedesktop.systemd1.xml index 6127541f8b..9fb215a136 100644 --- a/man/org.freedesktop.systemd1.xml +++ b/man/org.freedesktop.systemd1.xml @@ -162,6 +162,8 @@ node /org/freedesktop/systemd1 { Subscribe(); Unsubscribe(); Dump(out s output); + DumpPatterns(in as patterns, + out s output); DumpByFileDescriptor(out h fd); Reload(); @org.freedesktop.DBus.Method.NoReply("true") @@ -868,6 +870,8 @@ node /org/freedesktop/systemd1 { <variablelist class="dbus-method" generated="True" extra-ref="Dump()"/> + <variablelist class="dbus-method" generated="True" extra-ref="DumpPatterns()"/> + <variablelist class="dbus-method" generated="True" extra-ref="DumpByFileDescriptor()"/> <variablelist class="dbus-method" generated="True" extra-ref="Reload()"/> @@ -1338,7 +1342,9 @@ node /org/freedesktop/systemd1 { string guaranteed, and new fields may be added any time, and old fields removed. The general structure may be rearranged drastically between releases. This is exposed by <citerefentry><refentrytitle>systemd-analyze</refentrytitle><manvolnum>1</manvolnum></citerefentry>'s - <command>dump</command> command. The <function>DumpByFileDescriptor()</function> method is identical to + <command>dump</command> command. Similarly, <function>DumpPatterns()</function> returns the internal + state of units whose names match the glob expressions specified in the <varname>patterns</varname> + argument. The <function>DumpByFileDescriptor()</function> method is identical to <function>Dump()</function> but returns the data serialized into a file descriptor (the client should read the text data from it until hitting EOF). Given the size limits on D-Bus messages and the possibly large size of the returned string, <function>DumpByFileDescriptor()</function> is usually the |