X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Floginctl.xml;h=1b54ff7dc3d73232b5f03595b9db2b29fd25121e;hb=a3b6fafed441d96380a3f089118f7486d6aa3126;hp=af1d631cf4d4e1e9ccb17e2931415d80ac7ae3ed;hpb=18b754d345ecb0b15e369978aaffa72e9814b86a;p=elogind.git
diff --git a/man/loginctl.xml b/man/loginctl.xml
index af1d631cf..1b54ff7dc 100644
--- a/man/loginctl.xml
+++ b/man/loginctl.xml
@@ -8,20 +8,20 @@
Copyright 2010 Lennart Poettering
systemd is free software; you can redistribute it and/or modify it
- under the terms of the GNU General Public License as published by
- the Free Software Foundation; either version 2 of the License, or
+ under the terms of the GNU Lesser General Public License as published by
+ the Free Software Foundation; either version 2.1 of the License, or
(at your option) any later version.
systemd is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- General Public License for more details.
+ Lesser General Public License for more details.
- You should have received a copy of the GNU General Public License
+ You should have received a copy of the GNU Lesser General Public License
along with systemd; If not, see .
-->
-
+loginctl
@@ -49,7 +49,10 @@
- loginctl OPTIONSCOMMANDNAME
+ loginctl
+ OPTIONS
+ COMMAND
+ NAME
@@ -59,7 +62,7 @@
loginctl may be used to
introspect and control the state of the
systemd1
- login manager.
+ login manager systemd-logind.service8.
@@ -69,8 +72,8 @@
-
+ Prints a short help
text and exits.
@@ -84,39 +87,55 @@
-
+ When showing
- session/user/ properties, limit
+ session/user/seat properties, limit
display to certain properties as
specified as argument. If not
- specified all set properties are
+ specified, all set properties are
shown. The argument should be a
property name, such as
Sessions. If
- specified more than once all
+ specified more than once, all
properties with the specified names
are shown.
-
+ When showing
- unit/job/manager properties, show all
+ session/user/seat properties, show all
properties regardless whether they are
set or not.
+
+
+
+
+ Do not ellipsize
+ process tree entries.
+
+
- Do not pipe output into a
- pager.
-
+ Do not pipe output into a
+ pager.
+
+
+
+
+
+ Do not query the user
+ for authentication for privileged
+ operations.
+
@@ -128,23 +147,25 @@
to select whether
to kill only the leader process of the
session or all processes of the
- session. If omitted defaults to
+ session. If omitted, defaults to
.
-
+ When used with
kill-session or
kill-user, choose
which signal to send to selected
processes. Must be one of the well
- known signal specifiers such as
- SIGTERM, SIGINT or SIGSTOP. If omitted
- defaults to
- .
+ known signal specifiers, such as
+ SIGTERM,
+ SIGINT or
+ SIGSTOP. If
+ omitted, defaults to
+ SIGTERM.
@@ -153,7 +174,7 @@
Execute operation
remotely. Specify a hostname, or
- username and hostname separated by @,
+ username and hostname separated by @,
to connect to. This will use SSH to
talk to the remote login manager
instance.
@@ -196,14 +217,14 @@
Show properties of one
or more sessions or the manager
- itself. If no argument is specified
+ itself. If no argument is specified,
properties of the manager will be
- shown. If a session ID is specified
- properties of the session is shown. By
+ shown. If a session ID is specified,
+ properties of the session are shown. By
default, empty properties are
suppressed. Use
to show those too. To select specific
- properties to show use
+ properties to show, use
. This
command is intended to be used
whenever computer-parsable output is
@@ -234,6 +255,16 @@
sessions, if the session supports it.
+
+ lock-sessions
+ unlock-sessions
+
+ Activates/deactivates
+ the screen lock on all current
+ sessions supporting
+ it.
+
+
terminate-session [ID...]
@@ -282,14 +313,14 @@
Show properties of one
or more users or the manager
- itself. If no argument is specified
+ itself. If no argument is specified,
properties of the manager will be
- shown. If a user is specified
- properties of the user is shown. By
+ shown. If a user is specified,
+ properties of the user are shown. By
default, empty properties are
suppressed. Use
to show those too. To select specific
- properties to show use
+ properties to show, use
. This
command is intended to be used
whenever computer-parsable output is
@@ -306,10 +337,10 @@
Enable/disable user
lingering for one or more users. If
- enabled for a specific user a user
+ enabled for a specific user, a user
manager is spawned for him/her at
- boot, and kept around after
- logouts. This allows users who aren't
+ boot and kept around after
+ logouts. This allows users who are not
logged in to run long-running
services.
@@ -360,14 +391,14 @@
Show properties of one
or more seats or the manager
- itself. If no argument is specified
+ itself. If no argument is specified,
properties of the manager will be
- shown. If a seat is specified
+ shown. If a seat is specified,
properties of the seat are shown. By
default, empty properties are
suppressed. Use
to show those too. To select specific
- properties to show use
+ properties to show, use
. This
command is intended to be used
whenever computer-parsable output is
@@ -381,20 +412,22 @@
attach [NAME] [DEVICE...]
- 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 names. seat
+ 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, "-" and "_" and must be prefixed
- with "seat". To drop assignment of a
- device to a specific seat just
- reassign it to a different seat, or
- use
- flush-devices.
+ 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 seat, or use
+ flush-devices.
+
@@ -403,8 +436,8 @@
Removes all device
assignments previously created with
attach. After this
- call only automatically generated
- seats will remain and all seat
+ call, only automatically generated
+ seats will remain, and all seat
hardware is assigned to
them.
@@ -425,14 +458,14 @@
Exit status
- On success 0 is returned, a non-zero failure
+ On success, 0 is returned, a non-zero failure
code otherwise.Environment
-
+ $SYSTEMD_PAGERPager to use when
@@ -450,6 +483,7 @@
systemd1,
systemctl1,
+ systemd-logind.service8,
logind.conf5