X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Flogind.conf.xml;h=b0dd20f2a44eddbf99d36bc6cca02f852d1ad402;hb=ed1553a20d5bc73c1ae8e269d46ee24f80d259d4;hp=79a8932cea501b6a693817e644af93390c914254;hpb=64e441d0cfebd4c13df100c429b9adf5f1aea56b;p=elogind.git diff --git a/man/logind.conf.xml b/man/logind.conf.xml index 79a8932ce..b0dd20f2a 100644 --- a/man/logind.conf.xml +++ b/man/logind.conf.xml @@ -22,7 +22,7 @@ along with systemd; If not, see . --> - + logind.conf systemd @@ -71,14 +71,15 @@ Takes a positive integer. Configures how many virtual - terminals to allocate by default that - -- when switched to -- + terminals (VTs) to allocate by default + that -- when switched to and + previously unused -- autovt services are automatically spawned on. These services are instantiated from the - template + template unit autovt@.service - with the virtual terminal TTY name, + for the respective VT TTY name, e.g. autovt@tty4.service. By default autovt@.service @@ -86,12 +87,46 @@ getty@.service, i.e. login prompts are started dynamically as the user switches to - unused virtual terminals. 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 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 + getty available on + Alt-F6.). When set to 0, VT + reservation is disabled. @@ -106,6 +141,44 @@ no. + + 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 reported that they are idle, + and no idle inhibitor lock is active, + and subsquently the time configured + with IdleActionSec= + (see below) has passed. + + + + + IdleActionSec= + + Configures the delay + after which the action configured in + IdleAction= (see + above) is taken after the system is + idle. + + KillOnlyUsers= KillExcludeUsers= @@ -134,10 +207,17 @@ 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 + users logging in are added to, in + addition to the + name=systemd named + hierarchy. These settings take space + separated lists of controller + names. Pass the empty string to ensure + that logind does not touch any + hierarchies but systemd's own. When + logging in user sessions will get + private control groups in all + hierarchies listed in Controllers= and be reset to the root control group in all hierarchies listed in @@ -145,7 +225,15 @@ defaults to the empty list, ResetControllers= defaults to - cpu. + cpu. Note that for + all controllers that are not listed in + either Controllers= + nor + ResetControllers= + newly created sessions will be part of + the control groups of the system + service that created the + session. @@ -163,55 +251,74 @@ HandlePowerKey= - HandleSleepKey= + HandleSuspendKey= + HandleHibernateKey= HandleLidSwitch= Controls whether logind shall handle the system power and sleep keys and the lid switch to - trigger system power-off or - suspend. Can be one of - off, - no-session, - tty-session, - any-session and - always. If - off logind will + 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 - no-session logind - will handle these keys when no user is - logged in and no inhibitor lock is - taken, and trigger a warning beep - otherwise. If set to - tty-session logind - will handle these keys if no inhibitor - lock is taken, and either no user is - logged in or the foreground session is - a text login and the only one - existing. If - any-session is set - logind will handle these keys if no - inhibitor lock is taken, and either no - user is logged in or the foreground - session is the only one existing - (regardless whether graphical or - text). If set to - always logind will - handle these keys in any case, even if - one or more users are logged in or an - inhibitor lock is taken. Only input - devices with the + 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 + tag will be watched for key/lid switch events. HandlePowerKey= defaults to - no-session. - HandleSleepKey= - defaults to - tty-session, + poweroff. + HandleSuspendKey= + and HandleLidSwitch= + default to suspend. + HandleHibernateKey= + defaults to + hibernate. + + + + 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= + defaults to off, + LidSwitchIgnoreInhibited= defaults to - off. + yes. This means + that the lid switch does not respect + suspend blockers by default, but the + power and sleep keys do. + @@ -237,7 +344,7 @@ systemd1, systemd-logind.service8, loginctl1, - systemd.conf5 + systemd-system.conf5