X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Flogind.conf.xml;h=3a56c29627fbd8683a0cb506087a9e7102336268;hb=99d43b8fa4059271600d7b86e55224ce4309430d;hp=45d1257ef36994bab3fd6be4641020a1fca54fc1;hpb=7634579fb338f996cecb6f49b1183e0a4e491617;p=elogind.git
diff --git a/man/logind.conf.xml b/man/logind.conf.xml
index 45d1257ef..3a56c2962 100644
--- a/man/logind.conf.xml
+++ b/man/logind.conf.xml
@@ -54,9 +54,7 @@
Description
These files configure various parameters of the elogind
- login manager,
- logind.service8.
-
+ login manager.
@@ -64,195 +62,272 @@
Options
- All options are configured in the
- [Login] section:
-
-
-
-
- KillUserProcesses=
-
- Takes a boolean argument. Configures whether
- the processes of a user should be killed when the user
- completely logs out (i.e. after the user's last session
- ended). Defaults to no.
-
- Note that setting KillUserProcesses=1
- will break tools like
- screen1.
-
-
-
- KillOnlyUsers=
- KillExcludeUsers=
-
- These settings take space-separated lists of
- usernames that influence the effect of
- KillUserProcesses=. If not empty, only
- processes of users listed in KillOnlyUsers=
- will be killed when they log out entirely. Processes of users
- listed in KillExcludeUsers= are excluded
- from being killed. KillExcludeUsers=
- defaults to root and takes precedence over
- KillOnlyUsers=, which defaults to the empty
- list.
-
-
-
- IdleAction=
-
- Configures the action to take when the system
- is idle. Takes one of
- ignore,
- poweroff,
- reboot,
- halt,
- kexec,
- suspend,
- hibernate,
- hybrid-sleep, and
- 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
- 5.
-
-
-
- HandlePowerKey=
- HandleSuspendKey=
- HandleHibernateKey=
- HandleLidSwitch=
- HandleLidSwitchDocked=
-
- 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.
- HandleLidSwitchDocked= defaults to
- ignore.
- HandleHibernateKey= defaults to
- hibernate. If the system is inserted in a
- docking station, or if more than one display is connected, the
- action specified by HandleLidSwitchDocked=
- occurs; otherwise the HandleLidSwitch=
- action occurs.
-
-
-
- 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
- no, the inhibitor locks taken by
- applications in order to block the requested operation are
- respected. If yes, the requested operation
- is executed in any case.
- PowerKeyIgnoreInhibited=,
- SuspendKeyIgnoreInhibited= and
- HibernateKeyIgnoreInhibited= default to
- no.
- LidSwitchIgnoreInhibited= defaults to
- yes. This means that the lid switch does
- not respect suspend blockers by default, but the power and
- sleep keys do.
-
-
-
- HoldoffTimeoutSec=
-
- Specifies the timeout after system startup or
- system resume in which elogind will hold off on reacting to
- LID events. This is required for the system to properly
- detect any hotplugged devices so elogind can ignore LID events
- if external monitors, or docks, are connected. If set to 0,
- elogind will always react immediately, possibly before the
- kernel fully probed all hotplugged devices. This is safe, as
- long as you do not care for elogind to account for devices
- that have been plugged or unplugged while the system was off.
- Defaults to 30s.
-
-
-
- RuntimeDirectorySize=
-
- Sets the size limit on the
- $XDG_RUNTIME_DIR runtime directory for each
- user who logs in. Takes a size in bytes, optionally suffixed
- with the usual K, G, M, and T suffixes, to the base 1024
- (IEC). Alternatively, a numerical percentage suffixed by
- % may be specified, which sets the size
- limit relative to the amount of physical RAM. Defaults to 10%.
- Note that this size is a safety limit only. As each runtime
- directory is a tmpfs file system, it will only consume as much
- memory as is needed.
-
-
-
- RemoveIPC=
-
- Controls whether System V and POSIX IPC objects belonging to the user shall be removed when the
- user fully logs out. Takes a boolean argument. If enabled, the user may not consume IPC resources after the
- last of the user's sessions terminated. This covers System V semaphores, shared memory and message queues, as
- well as POSIX shared memory and message queues. Note that IPC objects of the root user and other system users
- are excluded from the effect of this setting. Defaults to yes.
-
-
-
+ All login options are configured in the
+ [Login] section, system sleep options are
+ configured in the [Sleep] section.
+
+ [Login] section:
+
+
+
+ KillUserProcesses=
+
+ Takes a boolean argument. Configures whether
+ the processes of a user should be killed when the user
+ completely logs out (i.e. after the user's last session
+ ended). Defaults to no.
+
+ Note that setting KillUserProcesses=1
+ will break tools like
+ screen1.
+
+
+
+ KillOnlyUsers=
+ KillExcludeUsers=
+
+ These settings take space-separated lists of
+ usernames that influence the effect of
+ KillUserProcesses=. If not empty, only
+ processes of users listed in KillOnlyUsers=
+ will be killed when they log out entirely. Processes of users
+ listed in KillExcludeUsers= are excluded
+ from being killed. KillExcludeUsers=
+ defaults to root and takes precedence over
+ KillOnlyUsers=, which defaults to the empty
+ list.
+
+
+
+ IdleAction=
+
+ Configures the action to take when the system
+ is idle. Takes one of
+ ignore,
+ poweroff,
+ reboot,
+ halt,
+ kexec,
+ suspend,
+ hibernate,
+ hybrid-sleep, and
+ 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
+ 5.
+
+
+
+ HandlePowerKey=
+ HandleSuspendKey=
+ HandleHibernateKey=
+ HandleLidSwitch=
+ HandleLidSwitchDocked=
+
+ 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.
+ HandleLidSwitchDocked= defaults to
+ ignore.
+ HandleHibernateKey= defaults to
+ hibernate. If the system is inserted in a
+ docking station, or if more than one display is connected, the
+ action specified by HandleLidSwitchDocked=
+ occurs; otherwise the HandleLidSwitch=
+ action occurs.
+
+
+
+ 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
+ no, the inhibitor locks taken by
+ applications in order to block the requested operation are
+ respected. If yes, the requested operation
+ is executed in any case.
+ PowerKeyIgnoreInhibited=,
+ SuspendKeyIgnoreInhibited= and
+ HibernateKeyIgnoreInhibited= default to
+ no.
+ LidSwitchIgnoreInhibited= defaults to
+ yes. This means that the lid switch does
+ not respect suspend blockers by default, but the power and
+ sleep keys do.
+
+
+
+ HoldoffTimeoutSec=
+
+ Specifies the timeout after system startup or
+ system resume in which elogind will hold off on reacting to
+ LID events. This is required for the system to properly
+ detect any hotplugged devices so elogind can ignore LID events
+ if external monitors, or docks, are connected. If set to 0,
+ elogind will always react immediately, possibly before the
+ kernel fully probed all hotplugged devices. This is safe, as
+ long as you do not care for elogind to account for devices
+ that have been plugged or unplugged while the system was off.
+ Defaults to 30s.
+
+
+
+ RuntimeDirectorySize=
+
+ Sets the size limit on the
+ $XDG_RUNTIME_DIR runtime directory for each
+ user who logs in. Takes a size in bytes, optionally suffixed
+ with the usual K, G, M, and T suffixes, to the base 1024
+ (IEC). Alternatively, a numerical percentage suffixed by
+ % may be specified, which sets the size
+ limit relative to the amount of physical RAM. Defaults to 10%.
+ Note that this size is a safety limit only. As each runtime
+ directory is a tmpfs file system, it will only consume as much
+ memory as is needed.
+
+
+
+ RemoveIPC=
+
+ Controls whether System V and POSIX IPC objects belonging to the user shall be removed when the
+ user fully logs out. Takes a boolean argument. If enabled, the user may not consume IPC resources after the
+ last of the user's sessions terminated. This covers System V semaphores, shared memory and message queues, as
+ well as POSIX shared memory and message queues. Note that IPC objects of the root user and other system users
+ are excluded from the effect of this setting. Defaults to yes.
+
+
+
+
+
+ [Sleep] section:
+
+ elogind supports three general
+ power-saving modes:
+
+
+
+ suspend
+
+ a low-power state
+ where execution of the OS is paused,
+ and complete power loss might result
+ in lost data, and which is fast to
+ enter and exit. This corresponds to
+ suspend, standby, or freeze states as
+ understood by the kernel.
+
+
+
+
+ hibernate
+
+ a low-power state
+ where execution of the OS is paused,
+ and complete power loss does not
+ result in lost data, and which might
+ be slow to enter and exit. This
+ corresponds to the hibernation as
+ understood by the kernel.
+
+
+
+
+ hybrid-sleep
+
+ a low-power state
+ where execution of the OS is paused,
+ which might be slow to enter, and on
+ complete power loss does not result in
+ lost data but might be slower to exit
+ in that case. This mode is called
+ suspend-to-both by the kernel.
+
+
+
+
+ SuspendMode=
+ HibernateMode=
+ HybridSleepMode=
+
+ The string to be written to
+ /sys/power/disk by elogind.
+ More than one value can be specified by separating
+ multiple values with whitespace. They will be tried
+ in turn, until one is written without error. If
+ neither succeeds, the operation will be aborted.
+
+
+
+
+ SuspendState=
+ HibernateState=
+ HybridSleepState=
+
+ The string to be written to
+ /sys/power/state by elogind.
+ More than one value can be specified by separating
+ multiple values with whitespace. They will be tried
+ in turn, until one is written without error. If
+ neither succeeds, the operation will be aborted.
+
+
+
+
+
See Also
- elogind1,
- logind.service8,
+ elogind8,
loginctl1,
- elogind-system.conf5