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=3d83d2c81ce7942823afe7ab540eb0825720a2d5;hb=deb480d1a7c3f3178c44f0aa73765181c0e2317f;hpb=8e7fd6ade44ce5dde0867ba748c7978ed1206865 diff --git a/man/logind.conf.xml b/man/logind.conf.xml index 3d83d2c81..54cc37904 100644 --- a/man/logind.conf.xml +++ b/man/logind.conf.xml @@ -22,7 +22,7 @@ along with systemd; If not, see . --> - + logind.conf systemd @@ -54,7 +54,7 @@ Description - This file configures various parameters of the systemd login manager systemd-logind.service8. + This file configures various parameters of the systemd login manager, systemd-logind.service8. @@ -72,8 +72,8 @@ Takes a positive integer. Configures how many virtual terminals (VTs) to allocate by default - that -- when switched to and - previously unused -- + that, when switched to and are + previously unused, autovt services are automatically spawned on. These services are instantiated from the @@ -81,7 +81,7 @@ autovt@.service for the respective VT TTY name, e.g. autovt@tty4.service. By - default + default, autovt@.service is linked to getty@.service, @@ -92,7 +92,7 @@ gettys are available on the VTs. If a VT is already used by some other subsystem - (for example a graphical login) this + (for example a graphical login), this kind of activation will not be attempted. Note that the VT configured in ReserveVT= is @@ -103,7 +103,7 @@ directive. Defaults to 6. When set to 0, automatic spawning of autovt services is - disabled. + disabled. @@ -116,14 +116,14 @@ autovt@.service activation (see above). The VT selected with this option will be - marked busy unconditionally so that no + marked busy unconditionally, so that no other subsystem will allocate it. This functionality is useful to ensure that - regardless how many VTs are allocated - by other subsystems one login + regardless of how many VTs are allocated + by other subsystems, one login getty is always - available. Defaults to 6 (with other - words: there'll always be a + available. Defaults to 6 (in other + words, there will always be a getty available on Alt-F6.). When set to 0, VT reservation is @@ -138,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. @@ -146,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= @@ -159,28 +164,46 @@ 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 in 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= - defaults to - cpu. + 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. @@ -190,8 +213,8 @@ time a system shutdown or sleep request is delayed due to an inhibitor lock of type delay - being active -- before it is ignored - and the operation executed + being active before the inhibitor is + ignored and the operation executes anyway. Defaults to 5s. @@ -211,13 +234,18 @@ poweroff, reboot, halt, - kexec and - hibernate. If - ignore logind will - never handle these keys. Otherwise the - specified action will be taken in the - respective event. Only input devices - with the + 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= @@ -243,17 +271,17 @@ sleep keys and the lid switch are subject to inhibitor locks. These settings take boolean arguments. If - off the inhibitor + off, the inhibitor locks taken by applications in order to block the requested operation are - respected, if on + respected. If on, the requested operation is executed in any case. PowerKeyIgnoreInhibited=, SuspendKeyIgnoreInhibited= and HibernateKeyIgnoreInhibited= - defaults to off, + default to off. LidSwitchIgnoreInhibited= defaults to yes. This means @@ -264,20 +292,6 @@ - - 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. @@ -286,7 +300,7 @@ systemd1, systemd-logind.service8, loginctl1, - systemd.conf5 + systemd-system.conf5