X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Floginctl.xml;h=39534f1159b1888e16e888168c97e78ee63ad534;hb=eaa952024d64e2e8211eb8861ad7141ad2f10b6d;hp=f0f5419ca7e2d5137c0be7017be8692ad7cc7d10;hpb=07045a1a92c839fd2af80bd0c060a595021bc3b3;p=elogind.git diff --git a/man/loginctl.xml b/man/loginctl.xml index f0f5419ca..39534f115 100644 --- a/man/loginctl.xml +++ b/man/loginctl.xml @@ -21,7 +21,8 @@ along with elogind; If not, see . --> - + loginctl @@ -62,7 +63,7 @@ loginctl may be used to introspect and control the state of the elogind8 - login manager. + login manager @@ -91,6 +92,16 @@ shown. + + + + + When printing properties with show, + only print the value, and skip the property name and + =. + + + @@ -156,11 +167,12 @@ - session-status ID... + session-status ID… Show terse runtime status information about - one or more sessions. Takes one or more session identifiers as - parameters. If no session identifiers are passed the status of + one or more 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 @@ -168,7 +180,7 @@ - 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 @@ -186,20 +198,20 @@ activate ID Activate a session. This brings a session into - the foreground, if another session is currently in the + 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 + 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. Takes one or more session identifiers as arguments. If no argument is - specified the session of the caller is locked/unlocked. + specified, the session of the caller is locked/unlocked. @@ -212,7 +224,7 @@ - terminate-session ID... + terminate-session ID… Terminates a session. This kills all processes of the session and deallocates all resources attached to the @@ -220,7 +232,7 @@ - kill-session ID... + kill-session ID… Send a signal to one or more processes of the session. Use to select which @@ -238,11 +250,12 @@ - user-status USER... + user-status USER… Show terse runtime status information about - one or more logged in users. Takes one or more user names or numeric - user IDs as parameters. If no parameters are passed the status + one or more 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 @@ -251,7 +264,7 @@ - show-user USER... + show-user USER… Show properties of one or more users or the manager itself. If no argument is specified, properties of the @@ -266,21 +279,24 @@ - 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 the user at boot and kept around after logouts. This allows users who are not logged in to run long-running 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. + argument. If no argument is specified, enables/disables + lingering for the user of the session of the caller. + + See also KillUserProcesses= setting in + logind.conf5. - 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 @@ -288,7 +304,7 @@ - kill-user USER... + kill-user USER… Send a signal to all processes of a user. Use to select the signal to send. @@ -305,7 +321,7 @@ - seat-status NAME... + seat-status NAME… Show terse runtime status information about one or more seats. Takes one or more seat names as parameters. @@ -317,7 +333,7 @@ - show-seat NAME... + show-seat NAME… Show properties of one or more seats or the manager itself. If no argument is specified, properties of the @@ -332,13 +348,13 @@ - attach NAME DEVICE... + attach NAME DEVICE… Persistently attach one or more devices to a seat. The devices should be specified via device paths in the /sys file system. To create a new seat, attach at least one graphics card to a previously unused seat - name. Seat names may consist only of a-z, A-Z, 0-9, + name. Seat names may consist only of a–z, A–Z, 0–9, - and _ and must be prefixed with seat. To drop assignment of a device to a specific seat, just reassign it to a different @@ -356,7 +372,7 @@ - terminate-seat NAME... + terminate-seat NAME… Terminates all sessions on a seat. This kills all processes of all sessions on the seat and deallocates all @@ -426,6 +442,37 @@ otherwise. + + Examples + + + Querying user status + + $ loginctl user-status +fatima (1005) + Since: Sat 2016-04-09 14:23:31 EDT; 54min ago + State: active + Sessions: 5 *3 + Unit: user-1005.slice + ├─user@1005.service + … + ├─session-3.scope + … + └─session-5.scope + ├─3473 login -- fatima + └─3515 -zsh + +Apr 09 14:40:30 laptop login[2325]: pam_unix(login:session): + session opened for user fatima by LOGIN(uid=0) +Apr 09 14:40:30 laptop login[2325]: LOGIN ON tty3 BY fatima + + + There are two sessions, 3 and 5. Session 3 is a graphical session, + marked with a star. The tree of processing including the two corresponding + scope units and the user manager unit are shown. + + +