X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Flogind.conf.xml;h=ca7525f31a3b7ba19715cb1cb2b461162207ec62;hp=7673201664a2e0038e0dcd2da81702b82ea7de81;hb=02b75c9edd61f47de7940b61b97b071b69f38a11;hpb=6a79c58603ea816a1b4fa1520397b4e138bc1ca0 diff --git a/man/logind.conf.xml b/man/logind.conf.xml index 767320166..ca7525f31 100644 --- a/man/logind.conf.xml +++ b/man/logind.conf.xml @@ -44,18 +44,42 @@ logind.conf - Login manager configuration file + logind.conf.d + Login manager configuration files /etc/systemd/logind.conf + /etc/systemd/logind.conf.d/*.conf + /run/systemd/logind.conf.d/*.conf + /usr/lib/systemd/logind.conf.d/*.conf Description - This file configures various parameters of the systemd login manager, systemd-logind.service8. - + These files configure various parameters of the systemd login manager, systemd-logind.service8. + + Each configuration file shall be named in the style of + filename.conf. + Files in /etc/ override files with the + same name in /usr/lib/ and + /run/. Files in + /run/ override files with the same name in + /usr/lib/. Packages should install their + configuration files in /usr/lib/. Files in + /etc/ are reserved for the local + administrator, who may use this logic to override the + configuration files installed by vendor packages. All + configuration files are sorted by their filename in + lexicographic order, regardless of which of the directories + they reside in. If multiple files specify the same option, the + entry in the file with the lexicographically latest name will + be applied; entries in any logind.conf.d + file override entries in + /etc/systemd/logind.conf. It is + recommended to prefix all filenames with a two-digit number and + a dash, to simplify the ordering of the files. @@ -80,25 +104,25 @@ template unit autovt@.service for the respective VT TTY name, - e.g. autovt@tty4.service. By + for example, autovt@tty4.service. By default, autovt@.service is linked to - getty@.service, - i.e. login prompts are started + getty@.service. + In other words, login prompts are started dynamically as the user switches 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 + (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 + the VTs configured with the NAutoVTs= directive. Defaults to 6. When set to 0, automatic spawning of @@ -110,7 +134,7 @@ ReserveVT= Takes a positive - integer. Configures the number of one + integer. Identifies one virtual terminal that shall unconditionally be reserved for autovt@.service @@ -118,7 +142,7 @@ selected with this option will be marked busy unconditionally, so that no other subsystem will allocate it. This - functionality is useful to ensure that + functionality is useful to ensure that, regardless of how many VTs are allocated by other subsystems, one login getty is always @@ -136,8 +160,8 @@ Takes a boolean argument. Configures whether the processes of a user should be killed - when she or he completely logs out (i.e. after - her/his last session ended). Defaults to + when the user completely logs out (i.e. after + the user's last session ended). Defaults to no. Note that setting @@ -180,7 +204,7 @@ kexec, suspend, hibernate, - hybrid-sleep, + hybrid-sleep, and lock. Defaults to ignore. @@ -216,7 +240,7 @@ being active before the inhibitor is ignored and the operation executes anyway. Defaults to - 5s. + 5. @@ -224,6 +248,7 @@ HandleSuspendKey= HandleHibernateKey= HandleLidSwitch= + HandleLidSwitchDocked= Controls whether logind shall handle the system power @@ -237,7 +262,7 @@ kexec, suspend, hibernate, - hybrid-sleep and + hybrid-sleep, and lock. If ignore, logind will never handle these keys. If @@ -255,13 +280,18 @@ and HandleLidSwitch= default to suspend. + HandleLidSwitchDocked= + defaults to ignore. HandleHibernateKey= defaults to - hibernate. Note - that the lid switch is ignored if the - system is inserted in a docking - station, or if more than one display - is connected. + 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. @@ -275,17 +305,17 @@ sleep keys and the lid switch are subject to inhibitor locks. These settings take boolean arguments. If - off, the inhibitor + no, the inhibitor locks taken by applications in order to block the requested operation are - respected. If on, + respected. If yes, the requested operation is executed in any case. PowerKeyIgnoreInhibited=, SuspendKeyIgnoreInhibited= and HibernateKeyIgnoreInhibited= - default to off. + default to no. LidSwitchIgnoreInhibited= defaults to yes. This means @@ -295,6 +325,48 @@ + + 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 are excluded + from the effect of this + setting. Defaults to + yes. + +