X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Floginctl.xml;h=11ed0ee46049cc98c106cb8fa1b7d1f037b8f61c;hp=7d4f26a3e7cee7eda942268fd5e5782cf9031446;hb=df99a9ef5bb7a89b92ccfb103b2f3e7046c62ef5;hpb=63ba209d8bc64137ff1585d5878328c93cb81b61 diff --git a/man/loginctl.xml b/man/loginctl.xml index 7d4f26a3e..11ed0ee46 100644 --- a/man/loginctl.xml +++ b/man/loginctl.xml @@ -21,7 +21,8 @@ along with systemd; If not, see . --> - + loginctl @@ -72,18 +73,11 @@ - - - - Prints a short help - text and exits. - - - - + - Prints a short version - string and exits. + Do not query the user + for authentication for privileged + operations. @@ -109,7 +103,7 @@ When showing session/user/seat properties, show all - properties regardless whether they are + properties regardless of whether they are set or not. @@ -122,21 +116,6 @@ - - - - Do not pipe output into a - pager. - - - - - - Do not query the user - for authentication for privileged - operations. - - @@ -169,30 +148,51 @@ - - - - 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. + + + + 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. + - - + + - Acquire privileges via - PolicyKit before executing the - operation. - + 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 @@ -200,20 +200,25 @@ - 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. - show-session [ID...] + show-session ID... Show properties of one or more sessions or the manager @@ -236,23 +241,31 @@ - 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. + @@ -261,22 +274,22 @@ Activates/deactivates the screen lock on all current - sessions supporting - it. + sessions supporting it. + - terminate-session [ID...] + terminate-session ID... - Terminates a - session. This kills all processes of - the session and deallocates all - resources attached to the - session. + Terminates a session. + This kills all processes of the + session and deallocates all resources + attached to the session. + - kill-session [ID...] + kill-session ID... Send a signal to one or more processes of the session. Use @@ -285,7 +298,9 @@ to select the signal to send. + + User Commands list-users @@ -294,22 +309,27 @@ - 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. + - show-user [USER...] + show-user USER... Show properties of one or more users or the manager @@ -332,39 +352,45 @@ - enable-linger [USER...] - disable-linger [USER...] + enable-linger USER... + disable-linger USER... Enable/disable user lingering for one or more users. If enabled for a specific user, a user - manager is spawned for him/her at + manager is spawned for the user at 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. - terminate-user [USER...] + terminate-user USER... Terminates all sessions of a user. This kills all processes of all sessions of the user and deallocates all runtime resources - attached to the - user. + attached to the user. + - kill-user [USER...] + kill-user USER... Send a signal to all processes of a user. Use to select the signal to send. + + Seat Commands list-seats @@ -374,12 +400,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 @@ -387,7 +416,7 @@ - show-seat [NAME...] + show-seat NAME... Show properties of one or more seats or the manager @@ -410,7 +439,7 @@ - attach [NAME] [DEVICE...] + attach NAME DEVICE... Persistently attach one or more devices to a seat. The @@ -443,15 +472,15 @@ - terminate-seat [NAME...] + terminate-seat NAME... Terminates all sessions on a seat. This kills all - processes of all sessions on a seat and - deallocates all runtime resources + processes of all sessions on the seat + and deallocates all runtime resources attached to them. - + @@ -462,21 +491,7 @@ code otherwise. - - Environment - - - - $SYSTEMD_PAGER - Pager to use when - is not given; - overrides $PAGER. Setting - this to an empty string or the value - cat is equivalent to passing - . - - - + See Also