X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Floginctl.xml;h=39534f1159b1888e16e888168c97e78ee63ad534;hp=45b0cf312566e1186eb7ae8509fb6c6efcaacbec;hb=c3e41400d106b6c2482d9d42298fac1a6a882071;hpb=b514d6c9dcc7c0d7353f975ecfb94f2197c73cf1
diff --git a/man/loginctl.xml b/man/loginctl.xml
index 45b0cf312..39534f115 100644
--- a/man/loginctl.xml
+++ b/man/loginctl.xml
@@ -21,7 +21,8 @@
along with elogind; If not, see .
-->
-
+loginctl
@@ -61,9 +62,8 @@
loginctl may be used to introspect and
control the state of the
- elogind1
- login manager
- logind.service8.
+ elogind8
+ login manager
@@ -92,6 +92,16 @@
shown.
+
+
+
+
+ When printing properties with show,
+ only print the value, and skip the property name and
+ =.
+
+
+
@@ -133,29 +143,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.
-
-
@@ -180,12 +167,12 @@
- session-statusID...
+ session-statusIDâ¦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
- parameters. If no session identifiers are passed the status of
+ 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
@@ -193,7 +180,7 @@
- show-sessionID...
+ show-sessionIDâ¦Show properties of one or more sessions or the
manager itself. If no argument is specified, properties of the
@@ -211,20 +198,20 @@
activateIDActivate 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-sessionID...
- unlock-sessionID...
+ lock-sessionIDâ¦
+ unlock-sessionIDâ¦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.
@@ -237,7 +224,7 @@
- terminate-sessionID...
+ terminate-sessionIDâ¦Terminates a session. This kills all processes
of the session and deallocates all resources attached to the
@@ -245,7 +232,7 @@
- kill-sessionID...
+ kill-sessionIDâ¦Send a signal to one or more processes of the
session. Use to select which
@@ -263,12 +250,12 @@
- user-statusUSER...
+ user-statusUSERâ¦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
- user IDs as parameters. If no parameters are passed the status
+ 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
@@ -277,7 +264,7 @@
- show-userUSER...
+ show-userUSERâ¦Show properties of one or more users or the
manager itself. If no argument is specified, properties of the
@@ -292,21 +279,24 @@
- enable-lingerUSER...
- disable-lingerUSER...
+ enable-lingerUSERâ¦
+ disable-lingerUSERâ¦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-userUSER...
+ terminate-userUSERâ¦Terminates all sessions of a user. This kills
all processes of all sessions of the user and deallocates all
@@ -314,7 +304,7 @@
- kill-userUSER...
+ kill-userUSERâ¦Send a signal to all processes of a user. Use
to select the signal to send.
@@ -331,7 +321,7 @@
- seat-statusNAME...
+ seat-statusNAMEâ¦Show terse runtime status information about
one or more seats. Takes one or more seat names as parameters.
@@ -343,7 +333,7 @@
- show-seatNAME...
+ show-seatNAMEâ¦Show properties of one or more seats or the
manager itself. If no argument is specified, properties of the
@@ -358,13 +348,13 @@
- attachNAMEDEVICE...
+ attachNAMEDEVICEâ¦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
@@ -382,7 +372,7 @@
- terminate-seatNAME...
+ terminate-seatNAMEâ¦Terminates all sessions on a seat. This kills
all processes of all sessions on the seat and deallocates all
@@ -390,8 +380,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
@@ -399,14 +442,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
- elogind1,
+ elogind8,
systemctl1,
- logind.service8,
logind.conf5