X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Floginctl.xml;h=5dd64e743bb3ec48e5893a23d5d1fea97ba1da08;hb=975a900782528b57deafadc10457c7ffab0b9791;hp=38f099edcce81c791d285d5e2ec5b917d5bb0ae0;hpb=21ac6ff143cc8bebfbd1818af28e8c6f82cd5265;p=elogind.git diff --git a/man/loginctl.xml b/man/loginctl.xml index 38f099edc..5dd64e743 100644 --- a/man/loginctl.xml +++ b/man/loginctl.xml @@ -72,28 +72,6 @@ The following options are understood: - - - - - Prints a short help - text and exits. - - - - - - Prints a short version - string and exits. - - - - - - Do not pipe output into a - pager. - - @@ -112,27 +90,6 @@ operations. - - - - - Execute the operation - remotely. Specify a hostname, or - username and hostname separated by @, - to connect to. This will use SSH to - talk to the remote login manager - instance. - - - - - - - Execute the operation on a - local container. Specify a container - name to connect to. - - @@ -200,11 +157,51 @@ SIGTERM. + + + + + When used with + user-status and + session-status, + controls the number of journal lines + to show, counting from the most recent + ones. Takes a positive integer + argument. Defaults to 10. + + + + + + + + When used with + user-status and + session-status, + controls the formatting of the journal + entries that are shown. For the + available choices, see + journalctl1. + Defaults to + short. + + + + + + + + + + + + Commands The following commands are understood: - + Session Commands + list-sessions @@ -212,14 +209,19 @@ - session-status ID... + session-status ID... Show terse runtime status information about one or more - sessions. This function is intended to - generate human-readable output. If you - are looking for computer-parsable - output, use + sessions, followed by the most recent + log data from the journal. Takes one + or more session identifiers as + parameters. If no session identifiers + are passed the status of the caller's + session is shown. This function is + intended to generate human-readable + output. If you are looking for + computer-parsable output, use show-session instead. @@ -248,23 +250,30 @@ - activate ID... - - Activate one or more - sessions. This brings one or more - sessions into the foreground, if - another session is currently in the - foreground on the respective - seat. + activate ID + + Activate a + session. This brings a session into + the foreground, if another session is + currently in the foreground on the + respective seat. Takes a session + identifier as argument. If no argument + is specified the session of the caller + is put into + foreground. - lock-session ID... - unlock-session ID... + lock-session ID... + unlock-session ID... Activates/deactivates the screen lock on one or more - sessions, if the session supports it. + sessions, if the session supports + it. Takes one or more session + identifiers as arguments. If no + argument is specified the session of + the caller is locked/unlocked. @@ -298,7 +307,9 @@ to select the signal to send. + + User Commands list-users @@ -307,17 +318,22 @@ - user-status USER... + user-status USER... Show terse runtime status information about one or more - logged in users. This function is - intended to generate human-readable - output. If you are looking for - computer-parsable output, use - show-user instead. - Users may be specified by their - usernames or numeric user IDs. + logged in users, followed by the most + recent log data from the + journal. Takes one or more user names + or numeric user IDs as parameters. If + no parameters are passed the status of + the caller's user is shown. This + function is intended to generate + human-readable output. If you are + looking for computer-parsable output, + use show-user + instead. Users may be specified by + their usernames or numeric user IDs. @@ -345,8 +361,8 @@ - enable-linger USER... - disable-linger USER... + enable-linger USER... + disable-linger USER... Enable/disable user lingering for one or more users. If @@ -355,7 +371,11 @@ boot and kept around after logouts. This allows users who are not logged in to run long-running - services. + services. Takes one or more user names + or numeric UIDs as argument. If no + argument is specified enables/disables + lingering for the user of the session + of the caller. @@ -377,7 +397,9 @@ to select the signal to send. + + Seat Commands list-seats @@ -387,12 +409,15 @@ - seat-status NAME... + seat-status NAME... Show terse runtime status information about one or more - seats. This function is - intended to generate human-readable + seats. Takes one or more seat names as + parameters. If no seat names are + passed the status of the caller's + session's seat is shown. This function + is intended to generate human-readable output. If you are looking for computer-parsable output, use show-seat @@ -400,7 +425,7 @@ - show-seat NAME... + show-seat NAME... Show properties of one or more seats or the manager @@ -464,7 +489,7 @@ and deallocates all runtime resources attached to them. - +