X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Floginctl.xml;h=7d4f26a3e7cee7eda942268fd5e5782cf9031446;hp=af1d631cf4d4e1e9ccb17e2931415d80ac7ae3ed;hb=63ba209d8bc64137ff1585d5878328c93cb81b61;hpb=18b754d345ecb0b15e369978aaffa72e9814b86a diff --git a/man/loginctl.xml b/man/loginctl.xml index af1d631cf..7d4f26a3e 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 OPTIONS COMMAND NAME + 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,32 +147,34 @@ 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. - Execute operation + Execute the 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_PAGER Pager to use when @@ -450,6 +483,7 @@ systemd1, systemctl1, + systemd-logind.service8, logind.conf5