From 5317451f124438c1721d2027e9e15b9bb360e3ff Mon Sep 17 00:00:00 2001 From: Mike Yuan Date: Thu, 4 Jan 2024 19:08:38 +0800 Subject: [PATCH] man/loginctl: document "self" and "auto" special session IDs 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. --- man/loginctl.xml | 19 +++++++++---------- 1 file changed, 9 insertions(+), 10 deletions(-) diff --git a/man/loginctl.xml b/man/loginctl.xml index 46113531b0..8a093c6e29 100644 --- a/man/loginctl.xml +++ b/man/loginctl.xml @@ -71,16 +71,15 @@ show-session ID… - Show properties of one or more sessions or the - manager itself. If no argument is specified, properties of the - manager will be shown. If a session ID is specified, - properties of the session are shown. By default, empty - properties are suppressed. Use to show - those too. To select specific properties to show, use - . This command is intended to be - used whenever computer-parsable output is required. Use - session-status if you are looking for - formatted human-readable output. + Show properties of one or more sessions or the manager itself. If no argument is + specified, properties of the manager will be shown. If a session ID is specified, properties of + the session are shown. Specially, if the given ID is self, the session to which + the loginctl process belongs is used. If auto, the current + session is used as with self if exists, and falls back to the current user's + graphical session. By default, empty properties are suppressed. Use to show + those too. To select specific properties to show, use . This command + is intended to be used whenever computer-parsable output is required. Use session-status + if you are looking for formatted human-readable output.