X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Floginctl.xml;h=39534f1159b1888e16e888168c97e78ee63ad534;hb=eb0e417895c37dbdb64f18ae95c6b1a7a99f871e;hp=fd2f15c0ac61beb68320d969922d6c8a9e8a644a;hpb=35bd3f136e3762fe35289def573133a1d9ac8a04;p=elogind.git
diff --git a/man/loginctl.xml b/man/loginctl.xml
index fd2f15c0a..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
@@ -166,11 +167,12 @@
- session-statusID...
+ session-statusIDâ¦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
@@ -178,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
@@ -196,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.
@@ -222,7 +224,7 @@
- terminate-sessionID...
+ terminate-sessionIDâ¦Terminates a session. This kills all processes
of the session and deallocates all resources attached to the
@@ -230,7 +232,7 @@
- kill-sessionID...
+ kill-sessionIDâ¦Send a signal to one or more processes of the
session. Use to select which
@@ -248,11 +250,12 @@
- user-statusUSER...
+ user-statusUSERâ¦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
@@ -261,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
@@ -276,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
@@ -298,7 +304,7 @@
- kill-userUSER...
+ kill-userUSERâ¦Send a signal to all processes of a user. Use
to select the signal to send.
@@ -315,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.
@@ -327,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
@@ -342,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
@@ -366,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
@@ -436,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.
+
+
+