X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Floginctl.xml;h=749db92ed13f57308ba4316c826484222ca500ec;hp=b9db4759837f93d9d82f25a8cb926352f2eafcb1;hb=93ae25e6fd62b2f87c3dd9ad3e81934eecc48057;hpb=409dee2e44e7dc73d6bf00d782938e4cb4105f5b diff --git a/man/loginctl.xml b/man/loginctl.xml index b9db47598..749db92ed 100644 --- a/man/loginctl.xml +++ b/man/loginctl.xml @@ -21,7 +21,8 @@ along with systemd; If not, see . --> - + loginctl @@ -49,7 +50,10 @@ - loginctl OPTIONS COMMAND NAME + loginctl + OPTIONS + COMMAND + NAME @@ -69,18 +73,21 @@ - - + - Prints a short help - text and exits. + + Do not print the legend, + i.e. the column headers and + the footer. + - + - Prints a short version - string and exits. + Do not query the user + for authentication for privileged + operations. @@ -88,7 +95,7 @@ When showing - session/user properties, limit + session/user/seat properties, limit display to certain properties as specified as argument. If not specified, all set properties are @@ -105,8 +112,8 @@ When showing - unit/job/manager properties, show all - properties regardless whether they are + session/user/seat properties, show all + properties regardless of whether they are set or not. @@ -114,26 +121,11 @@ - Do not ellipsize cgroup - members. + Do not ellipsize + process tree entries. - - - - Do not pipe output into a - pager. - - - - - - Do not query the user - for authentication for privileged - operations. - - @@ -165,26 +157,12 @@ SIGTERM. - - - - - Execute 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. - + + - - - - - Acquire privileges via - PolicyKit before executing the - operation. - + + + The following commands are understood: @@ -197,7 +175,7 @@ - session-status [ID...] + session-status ID... Show terse runtime status information about one or more @@ -210,14 +188,14 @@ - show-session [ID...] + 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 is shown. By + properties of the session are shown. By default, empty properties are suppressed. Use to show those too. To select specific @@ -233,7 +211,7 @@ - activate [ID...] + activate ID... Activate one or more sessions. This brings one or more @@ -244,12 +222,13 @@ - 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. + @@ -258,22 +237,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 @@ -291,7 +270,7 @@ - user-status [USER...] + user-status USER... Show terse runtime status information about one or more @@ -299,14 +278,14 @@ 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 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 @@ -329,13 +308,13 @@ - 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 @@ -343,18 +322,18 @@ - 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 @@ -371,7 +350,7 @@ - seat-status [NAME...] + seat-status NAME... Show terse runtime status information about one or more @@ -384,7 +363,7 @@ - show-seat [NAME...] + show-seat NAME... Show properties of one or more seats or the manager @@ -407,7 +386,7 @@ - attach [NAME] [DEVICE...] + attach NAME DEVICE... Persistently attach one or more devices to a seat. The @@ -440,12 +419,12 @@ - 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. @@ -459,21 +438,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