system/systemd
system/systemd
1
0
Fork 0
mirror of https://github.com/systemd/systemd synced 2024-07-22 10:44:58 +00:00
Code Issues Actions 5 Packages Projects Releases Wiki Activity

man/loginctl: document "self" and "auto" special session IDs

Browse source 
session-status automatically uses "auto" if no ID is specified,
but show-session shows the manager's properties. Let's document
these special values so that users of show-session can benefit too.
This commit is contained in:
Mike Yuan 2024-01-04 19:08:38 +08:00
parent 771240fa3d
commit 5317451f12
No known key found for this signature in database
GPG key ID: 417471C0A40F58B3
1 changed files with 9 additions and 10 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

19
man/loginctl.xml
View file

@ -71,16 +71,15 @@
<varlistentry> <varlistentry>
<term><command>show-session</command> <optional><replaceable>ID</replaceable>…</optional></term> <term><command>show-session</command> <optional><replaceable>ID</replaceable>…</optional></term>
<listitem><para>Show properties of one or more sessions or the <listitem><para>Show properties of one or more sessions or the manager itself. If no argument is
manager itself. If no argument is specified, properties of the specified, properties of the manager will be shown. If a session ID is specified, properties of
manager will be shown. If a session ID is specified, the session are shown. Specially, if the given ID is <literal>self</literal>, the session to which
properties of the session are shown. By default, empty the <command>loginctl</command> process belongs is used. If <literal>auto</literal>, the current
properties are suppressed. Use <option>--all</option> to show session is used as with <literal>self</literal> if exists, and falls back to the current user's
those too. To select specific properties to show, use graphical session. By default, empty properties are suppressed. Use <option>--all</option> to show
<option>--property=</option>. This command is intended to be those too. To select specific properties to show, use <option>--property=</option>. This command
used whenever computer-parsable output is required. Use is intended to be used whenever computer-parsable output is required. Use <command>session-status</command>
<command>session-status</command> if you are looking for if you are looking for formatted human-readable output.</para>
formatted human-readable output.</para>
<xi:include href="version-info.xml" xpointer="v233"/></listitem> <xi:include href="version-info.xml" xpointer="v233"/></listitem>
</varlistentry> </varlistentry>