Skip to content

Commit ea539eb

Browse files
committed
man: information about available properties
https://bugzilla.redhat.com/show_bug.cgi?id=1144496
1 parent 8914ea0 commit ea539eb

File tree

1 file changed

+23
-5
lines changed

1 file changed

+23
-5
lines changed

man/systemctl.xml

Lines changed: 23 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -114,12 +114,30 @@
114114

115115
<listitem>
116116
<para>When showing unit/job/manager properties with the
117-
<command>show</command> command, limit display to certain
118-
properties as specified as argument. If not specified, all
119-
set properties are shown. The argument should be a
117+
<command>show</command> command, limit display to properties
118+
specified in the argument. The argument should be a
120119
comma-separated list of property names, such as
121-
<literal>MainPID</literal>. If specified more than once, all
122-
properties with the specified names are shown.</para>
120+
<literal>MainPID</literal>. Unless specified, all known
121+
properties are shown. If specified more than once, all
122+
properties with the specified names are shown. Shell
123+
completion is implemented for property names.</para>
124+
125+
<para>For the manager itself,
126+
<command>systemctl show</command> will show all available
127+
properties. Those properties are documented in
128+
<citerefentry><refentrytitle>systemd-system.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
129+
</para>
130+
131+
<para>Properties for units vary by unit type, so showing any
132+
unit (even a non-existent one) is a way to list properties
133+
pertaining to this type. Similarly showing any job will list
134+
properties pertaining to all jobs. Properties for units are
135+
documented in
136+
<citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
137+
and the pages for individual unit types
138+
<citerefentry><refentrytitle>systemd.service</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
139+
<citerefentry><refentrytitle>systemd.socket</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
140+
etc.</para>
123141
</listitem>
124142
</varlistentry>
125143

0 commit comments

Comments
 (0)