X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Floginctl.xml;h=5ff9f75059c94859fba02d0f644e344b7d47088b;hp=d9e985900175a9645ff5fa98430971d7f89303d3;hb=3c7560019e623e6e0d03a860b4f19a3a8715feca;hpb=f8f14b3654bcd8d6c6cfd118e50775f6a2328a35
diff --git a/man/loginctl.xml b/man/loginctl.xml
index d9e985900..5ff9f7505 100644
--- a/man/loginctl.xml
+++ b/man/loginctl.xml
@@ -21,7 +21,8 @@
along with systemd; If not, see .
-->
-
+loginctl
@@ -72,25 +73,13 @@
-
-
+
- Prints a short help
- text and exits.
-
-
-
-
-
- Prints a short version
- string and exits.
-
-
-
-
-
- Do not pipe output into a
- pager.
+
+ Do not print the legend,
+ i.e. the column headers and
+ the footer.
+
@@ -101,27 +90,6 @@
operations.
-
-
-
-
- Execute the 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.
-
-
-
-
-
-
- Execute the operation on a
- local container. Specify a container
- name to connect to.
-
-
@@ -145,7 +113,7 @@
When showing
session/user/seat properties, show all
- properties regardless whether they are
+ properties regardless of whether they are
set or not.
@@ -189,6 +157,41 @@
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.
+
+
+
+
+
+
+
+ The following commands are understood:
@@ -201,20 +204,21 @@
- session-status [ID...]
+ session-statusID...Show terse runtime
status information about one or more
- sessions. This function is intended to
- generate human-readable output. If you
- are looking for computer-parsable
- output, use
- show-session
+ sessions, followed by the most recent
+ log data from the journal. This
+ function is intended to generate
+ human-readable output. If you are
+ looking for computer-parsable output,
+ use show-session
instead.
- show-session [ID...]
+ show-sessionID...Show properties of one
or more sessions or the manager
@@ -237,7 +241,7 @@
- activate [ID...]
+ activateID...Activate one or more
sessions. This brings one or more
@@ -248,12 +252,13 @@
- lock-session [ID...]
- unlock-session [ID...]
+ lock-sessionID...
+ unlock-sessionID...Activates/deactivates
the screen lock on one or more
- sessions, if the session supports it.
+ sessions, if the session supports it.
+
@@ -262,22 +267,22 @@
Activates/deactivates
the screen lock on all current
- sessions supporting
- it.
+ sessions supporting it.
+
- terminate-session [ID...]
+ terminate-sessionID...
- 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-sessionID...Send a signal to one
or more processes of the session. Use
@@ -295,22 +300,23 @@
- user-status [USER...]
+ user-statusUSER...Show terse runtime
status information about one or more
- logged in users. This function is
- 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.
+ logged in users, followed by the most
+ recent log data from the journal. This
+ function is 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 [USER...]
+ show-userUSER...Show properties of one
or more users or the manager
@@ -333,13 +339,13 @@
- enable-linger [USER...]
- disable-linger [USER...]
+ 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 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
@@ -347,18 +353,18 @@
- terminate-user [USER...]
+ terminate-userUSER...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-userUSER...Send a signal to all
processes of a user. Use
@@ -375,7 +381,7 @@
- seat-status [NAME...]
+ seat-statusNAME...Show terse runtime
status information about one or more
@@ -388,7 +394,7 @@
- show-seat [NAME...]
+ show-seatNAME...Show properties of one
or more seats or the manager
@@ -411,7 +417,7 @@
- attach [NAME] [DEVICE...]
+ attachNAMEDEVICE...Persistently attach
one or more devices to a seat. The
@@ -444,12 +450,12 @@
- terminate-seat [NAME...]
+ terminate-seatNAME...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.
@@ -463,21 +469,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