X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Flogind.conf.xml;h=54cc3790486d8498eb0067c86ed45d122e2ca953;hp=950f81fa937072242ca97ab256038d7e7b65c1df;hb=e7176abbe818c75c6acd90227a7a84c3e05fee31;hpb=18b754d345ecb0b15e369978aaffa72e9814b86a diff --git a/man/logind.conf.xml b/man/logind.conf.xml index 950f81fa9..54cc37904 100644 --- a/man/logind.conf.xml +++ b/man/logind.conf.xml @@ -9,20 +9,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 . --> - + logind.conf systemd @@ -48,13 +48,13 @@ - logind.conf + /etc/systemd/logind.conf Description - This files configures various parameters of the systemd login manager. + This file configures various parameters of the systemd login manager, systemd-logind.service8. @@ -70,30 +70,66 @@ NAutoVTs= Takes a positive - integer. How many virtual terminals to - allocate by default and when switched - to autospawn autovt - services on (if they are otherwise - unused). These services are - instantiated from a template of + integer. Configures how many virtual + terminals (VTs) to allocate by default + that, when switched to and are + previously unused, + autovt services are + automatically spawned on. These + services are instantiated from the + template unit autovt@.service - with the virtual terminal TTY name, + for the respective VT TTY name, e.g. autovt@tty4.service. By - default + default, autovt@.service is linked to getty@.service, i.e. login prompts are started dynamically as the user switches to - unused virtual terminals, and this - parameter hence controls how many - gettys are available on the virtual - terminals. Defaults to 6. When set to + unused virtual terminals. Hence, this + parameter controls how many login + gettys are + available on the VTs. If a VT is + already used by some other subsystem + (for example a graphical login), this + kind of activation will not be + attempted. Note that the VT configured + in ReserveVT= is + always subject to this kind of + activation, even if it is not one of + VTs configured with the + NAutoVTs= + directive. Defaults to 6. When set to 0, automatic spawning of autovt services is disabled. + + ReserveVT= + + Takes a positive + integer. Configures the number of one + virtual terminal that shall + unconditionally be reserved for + autovt@.service + activation (see above). The VT + selected with this option will be + marked busy unconditionally, so that no + other subsystem will allocate it. This + functionality is useful to ensure that + regardless of how many VTs are allocated + by other subsystems, one login + getty is always + available. Defaults to 6 (in other + words, there will always be a + getty available on + Alt-F6.). When set to 0, VT + reservation is + disabled. + + KillUserProcesses= @@ -102,7 +138,12 @@ processes of a user should be killed when she or he completely logs out (i.e. after her/his last session ended). Defaults to - no. + no. + + Note that setting + KillUserProcesses=1 + will break tools like + screen1. @@ -110,12 +151,12 @@ KillExcludeUsers= These settings take - space separated lists of user names + space-separated lists of usernames that influence the effect of KillUserProcesses=. If - not empty only processes of users + not empty, only processes of users listed in - KillOnlyUsers will + KillOnlyUsers= will be killed when they log out entirely. Processes of users listed in KillExcludeUsers= @@ -123,52 +164,143 @@ killed. KillExcludeUsers= defaults to root and takes precedence over - KillOnlyUsers= + KillOnlyUsers=, which defaults to the empty list. - Controllers= - ResetControllers= - - These settings control - the default control group hierarchies - users logging are added to. When - logging in users will get private - control groups in all hierarchies - listed in - Controllers= and be - reset to the root control group in all - hierarchies listed in - ResetControllers=. Controllers= - defaults to the empty list, - ResetControllers= + IdleAction= + + Configures the action + to take when the system is idle. Takes + one of ignore, + poweroff, + reboot, + halt, + kexec, + suspend, + hibernate, + hybrid-sleep, + lock. Defaults to + ignore. + + Note that this requires that + user sessions correctly report the + idle status to the system. The system + will execute the action after all + sessions report that they are idle, + no idle inhibitor lock is active, + and subsequently, the time configured + with IdleActionSec= + (see below) has expired. + + + + + IdleActionSec= + + Configures the delay + after which the action configured in + IdleAction= (see + above) is taken after the system is + idle. + + + + InhibitDelayMaxSec= + + Specifies the maximum + time a system shutdown or sleep + request is delayed due to an inhibitor + lock of type delay + being active before the inhibitor is + ignored and the operation executes + anyway. Defaults to + 5s. + + + + HandlePowerKey= + HandleSuspendKey= + HandleHibernateKey= + HandleLidSwitch= + + Controls whether + logind shall handle the system power + and sleep keys and the lid switch to + trigger actions such as system + power-off or suspend. Can be one of + ignore, + poweroff, + reboot, + halt, + kexec, + suspend, + hibernate, + hybrid-sleep and + lock. If + ignore, logind will + never handle these keys. If + lock, all running + sessions will be screen-locked; otherwise, + the specified action + will be taken in the respective + event. Only input devices with the + power-switch udev + tag will be watched for key/lid switch + events. HandlePowerKey= + defaults to + poweroff. + HandleSuspendKey= + and + HandleLidSwitch= + default to suspend. + HandleHibernateKey= defaults to - cpu. + hibernate. - - Note that setting - KillUserProcesses=1 will break tools - like - screen1. - - Note that KillUserProcesses=1 - is a weaker version of - kill-session-processes=1 which may - be configured per-service for - pam_systemd8. The - latter kills processes of a session as soon as it - ends, the former kills processes as soon as the last - session of the user ends. + + PowerKeyIgnoreInhibited= + SuspendKeyIgnoreInhibited= + HibernateKeyIgnoreInhibited= + LidSwitchIgnoreInhibited= + + Controls whether + actions triggered by the power and + sleep keys and the lid switch are + subject to inhibitor locks. These + settings take boolean arguments. If + off, the inhibitor + locks taken by applications in order + to block the requested operation are + respected. If on, + the requested operation is executed in + any + case. PowerKeyIgnoreInhibited=, + SuspendKeyIgnoreInhibited= + and + HibernateKeyIgnoreInhibited= + default to off. + LidSwitchIgnoreInhibited= + defaults to + yes. This means + that the lid switch does not respect + suspend blockers by default, but the + power and sleep keys do. + + + + See Also systemd1, + systemd-logind.service8, loginctl1, - systemd.conf5 + systemd-system.conf5