X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Floginctl.xml;h=46f1a990f8ffd2132f50bde6f00fa7407d9da9e8;hp=9dda14d4548df1da386bde21a8317281da380000;hb=2b18106e03096fec69dbd821a126241981a1febd;hpb=798d3a524ea57aaf40cb53858aaa45ec702f012d diff --git a/man/loginctl.xml b/man/loginctl.xml index 9dda14d45..46f1a990f 100644 --- a/man/loginctl.xml +++ b/man/loginctl.xml @@ -3,30 +3,29 @@ "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> - + loginctl - systemd + elogind @@ -45,7 +44,7 @@ loginctl - Control the systemd login manager + Control the elogind login manager @@ -62,9 +61,8 @@ loginctl may be used to introspect and control the state of the - systemd1 - login manager - systemd-logind.service8. + elogind8 + login manager. @@ -93,6 +91,16 @@ shown. + + + + + When printing properties with show, + only print the value, and skip the property name and + =. + + + @@ -134,29 +142,6 @@ 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. - - @@ -184,8 +169,7 @@ session-status ID... Show terse runtime status information about - one or more sessions, followed by the most recent log data - from the journal. Takes one or more session identifiers as + one or more sessions. 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 @@ -212,9 +196,9 @@ 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. @@ -225,7 +209,7 @@ 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. @@ -267,8 +251,7 @@ user-status USER... Show terse runtime status information about - one or more logged in users, followed by the most recent log - data from the journal. Takes one or more user names or numeric + 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 of the caller's user is shown. This function is intended to generate human-readable output. If you are looking for @@ -301,8 +284,11 @@ 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. @@ -365,7 +351,7 @@ 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 @@ -391,8 +377,61 @@ + System Commands + + + poweroff + + + Print a wall message to all users, shut down and + power-off the system. + + + + reboot arg + + + Print a wall message to all users, shut down and + reboot the system. + + If the optional argument + arg is given, it will be passed + as the optional argument to the + reboot2 + system call. The value is architecture and firmware + specific. As an example, recovery might + be used to trigger system recovery, and + fota might be used to trigger a + firmware over the air update. + + + + + suspend + + + Suspend the system. + + + + + + hibernate + + + Hibernate the system. + + + + + + hybrid-sleep + + + Hibernate and suspend the system. + + - Exit status @@ -400,14 +439,44 @@ 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. + + + See Also - systemd1, + elogind8, systemctl1, - systemd-logind.service8, logind.conf5