logind.conf.xml revision f59d94bce04f18c7430676fdc819183c17dd9612
76318284fc970b30e9dc4c079960807345331dadLennart Poettering<?xml version='1.0'?> <!--*- Mode: nxml; nxml-child-indent: 2; indent-tabs-mode: nil -*-->
76318284fc970b30e9dc4c079960807345331dadLennart Poettering<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
76318284fc970b30e9dc4c079960807345331dadLennart Poettering "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
76318284fc970b30e9dc4c079960807345331dadLennart Poettering
76318284fc970b30e9dc4c079960807345331dadLennart Poettering<!--
76318284fc970b30e9dc4c079960807345331dadLennart Poettering This file is part of systemd.
76318284fc970b30e9dc4c079960807345331dadLennart Poettering
76318284fc970b30e9dc4c079960807345331dadLennart Poettering Copyright 2010 Lennart Poettering
5430f7f2bc7330f3088b894166bf3524a067e3d8Lennart Poettering
5430f7f2bc7330f3088b894166bf3524a067e3d8Lennart Poettering systemd is free software; you can redistribute it and/or modify it
76318284fc970b30e9dc4c079960807345331dadLennart Poettering under the terms of the GNU Lesser General Public License as published by
76318284fc970b30e9dc4c079960807345331dadLennart Poettering the Free Software Foundation; either version 2.1 of the License, or
76318284fc970b30e9dc4c079960807345331dadLennart Poettering (at your option) any later version.
76318284fc970b30e9dc4c079960807345331dadLennart Poettering
76318284fc970b30e9dc4c079960807345331dadLennart Poettering systemd is distributed in the hope that it will be useful, but
5430f7f2bc7330f3088b894166bf3524a067e3d8Lennart Poettering WITHOUT ANY WARRANTY; without even the implied warranty of
76318284fc970b30e9dc4c079960807345331dadLennart Poettering MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
5430f7f2bc7330f3088b894166bf3524a067e3d8Lennart Poettering Lesser General Public License for more details.
76318284fc970b30e9dc4c079960807345331dadLennart Poettering
76318284fc970b30e9dc4c079960807345331dadLennart Poettering You should have received a copy of the GNU Lesser General Public License
76318284fc970b30e9dc4c079960807345331dadLennart Poettering along with systemd; If not, see <http://www.gnu.org/licenses/>.
76318284fc970b30e9dc4c079960807345331dadLennart Poettering-->
76318284fc970b30e9dc4c079960807345331dadLennart Poettering
76318284fc970b30e9dc4c079960807345331dadLennart Poettering<refentry id="logind.conf" conditional='ENABLE_LOGIND'
d77c25b1164f55fe3f9b5ad00c47c0e01243ad53Johan Ouwerkerk xmlns:xi="http://www.w3.org/2001/XInclude">
d77c25b1164f55fe3f9b5ad00c47c0e01243ad53Johan Ouwerkerk <refentryinfo>
d77c25b1164f55fe3f9b5ad00c47c0e01243ad53Johan Ouwerkerk <title>logind.conf</title>
d77c25b1164f55fe3f9b5ad00c47c0e01243ad53Johan Ouwerkerk <productname>systemd</productname>
d77c25b1164f55fe3f9b5ad00c47c0e01243ad53Johan Ouwerkerk
d77c25b1164f55fe3f9b5ad00c47c0e01243ad53Johan Ouwerkerk <authorgroup>
d77c25b1164f55fe3f9b5ad00c47c0e01243ad53Johan Ouwerkerk <author>
d77c25b1164f55fe3f9b5ad00c47c0e01243ad53Johan Ouwerkerk <contrib>Developer</contrib>
d77c25b1164f55fe3f9b5ad00c47c0e01243ad53Johan Ouwerkerk <firstname>Lennart</firstname>
d77c25b1164f55fe3f9b5ad00c47c0e01243ad53Johan Ouwerkerk <surname>Poettering</surname>
76318284fc970b30e9dc4c079960807345331dadLennart Poettering <email>lennart@poettering.net</email>
ecca17f6eec83b58f39ff5dc7894044c524ddf41Kay Sievers </author>
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek </authorgroup>
ecca17f6eec83b58f39ff5dc7894044c524ddf41Kay Sievers </refentryinfo>
ecca17f6eec83b58f39ff5dc7894044c524ddf41Kay Sievers
ecca17f6eec83b58f39ff5dc7894044c524ddf41Kay Sievers <refmeta>
ecca17f6eec83b58f39ff5dc7894044c524ddf41Kay Sievers <refentrytitle>logind.conf</refentrytitle>
ecca17f6eec83b58f39ff5dc7894044c524ddf41Kay Sievers <manvolnum>5</manvolnum>
ecca17f6eec83b58f39ff5dc7894044c524ddf41Kay Sievers </refmeta>
ecca17f6eec83b58f39ff5dc7894044c524ddf41Kay Sievers
ecca17f6eec83b58f39ff5dc7894044c524ddf41Kay Sievers <refnamediv>
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek <refname>logind.conf</refname>
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek <refname>logind.conf.d</refname>
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek <refpurpose>Login manager configuration files</refpurpose>
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek </refnamediv>
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek <refsynopsisdiv>
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek <para><filename>/etc/systemd/logind.conf</filename></para>
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek <para><filename>/etc/systemd/logind.conf.d/*.conf</filename></para>
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek <para><filename>/run/systemd/logind.conf.d/*.conf</filename></para>
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek <para><filename>/usr/lib/systemd/logind.conf.d/*.conf</filename></para>
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek </refsynopsisdiv>
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek <refsect1>
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek <title>Description</title>
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek <para>These files configure various parameters of the systemd
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek login manager,
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd-logind.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek </para>
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek </refsect1>
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek <xi:include href="standard-conf.xml" xpointer="main-conf" />
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek <refsect1>
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek <title>Options</title>
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek <para>All options are configured in the
74a6d87d0cd1f2213869e168b6ca55eded6f4ae8Zbigniew Jędrzejewski-Szmek <literal>[Login]</literal> section:</para>
74a6d87d0cd1f2213869e168b6ca55eded6f4ae8Zbigniew Jędrzejewski-Szmek
74a6d87d0cd1f2213869e168b6ca55eded6f4ae8Zbigniew Jędrzejewski-Szmek <variablelist>
74a6d87d0cd1f2213869e168b6ca55eded6f4ae8Zbigniew Jędrzejewski-Szmek
74a6d87d0cd1f2213869e168b6ca55eded6f4ae8Zbigniew Jędrzejewski-Szmek <varlistentry>
74a6d87d0cd1f2213869e168b6ca55eded6f4ae8Zbigniew Jędrzejewski-Szmek <term><varname>NAutoVTs=</varname></term>
74a6d87d0cd1f2213869e168b6ca55eded6f4ae8Zbigniew Jędrzejewski-Szmek
74a6d87d0cd1f2213869e168b6ca55eded6f4ae8Zbigniew Jędrzejewski-Szmek <listitem><para>Takes a positive integer. Configures how many
74a6d87d0cd1f2213869e168b6ca55eded6f4ae8Zbigniew Jędrzejewski-Szmek virtual terminals (VTs) to allocate by default that, when
74a6d87d0cd1f2213869e168b6ca55eded6f4ae8Zbigniew Jędrzejewski-Szmek switched to and are previously unused,
74a6d87d0cd1f2213869e168b6ca55eded6f4ae8Zbigniew Jędrzejewski-Szmek <literal>autovt</literal> services are automatically spawned
74a6d87d0cd1f2213869e168b6ca55eded6f4ae8Zbigniew Jędrzejewski-Szmek on. These services are instantiated from the template unit
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek <filename>autovt@.service</filename> for the respective VT TTY
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek name, for example, <filename>autovt@tty4.service</filename>.
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek By default, <filename>autovt@.service</filename> is linked to
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek <filename>getty@.service</filename>. In other words, login
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek prompts are started dynamically as the user switches to unused
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek virtual terminals. Hence, this parameter controls how many
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek login <literal>gettys</literal> are available on the VTs. If a
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek VT is already used by some other subsystem (for example, a
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek graphical login), this kind of activation will not be
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek attempted. Note that the VT configured in
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek <varname>ReserveVT=</varname> is always subject to this kind
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek of activation, even if it is not one of the VTs configured
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek with the <varname>NAutoVTs=</varname> directive. Defaults to
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek 6. When set to 0, automatic spawning of
5aded369782f28255bc6b494ca905d7acaea7a56Zbigniew Jędrzejewski-Szmek <literal>autovt</literal> services is
b5c7d097ec7d16facaaeb0da5ba2abb2b1fc230bZbigniew Jędrzejewski-Szmek disabled.</para></listitem>
b5c7d097ec7d16facaaeb0da5ba2abb2b1fc230bZbigniew Jędrzejewski-Szmek </varlistentry>
b5c7d097ec7d16facaaeb0da5ba2abb2b1fc230bZbigniew Jędrzejewski-Szmek
b5c7d097ec7d16facaaeb0da5ba2abb2b1fc230bZbigniew Jędrzejewski-Szmek <varlistentry>
b5c7d097ec7d16facaaeb0da5ba2abb2b1fc230bZbigniew Jędrzejewski-Szmek <term><varname>ReserveVT=</varname></term>
b5c7d097ec7d16facaaeb0da5ba2abb2b1fc230bZbigniew Jędrzejewski-Szmek
b5c7d097ec7d16facaaeb0da5ba2abb2b1fc230bZbigniew Jędrzejewski-Szmek <listitem><para>Takes a positive integer. Identifies one
b5c7d097ec7d16facaaeb0da5ba2abb2b1fc230bZbigniew Jędrzejewski-Szmek virtual terminal that shall unconditionally be reserved for
b5c7d097ec7d16facaaeb0da5ba2abb2b1fc230bZbigniew Jędrzejewski-Szmek <filename>autovt@.service</filename> activation (see above).
b5c7d097ec7d16facaaeb0da5ba2abb2b1fc230bZbigniew Jędrzejewski-Szmek The VT selected with this option will be marked busy
b5c7d097ec7d16facaaeb0da5ba2abb2b1fc230bZbigniew Jędrzejewski-Szmek unconditionally, so that no other subsystem will allocate it.
b5c7d097ec7d16facaaeb0da5ba2abb2b1fc230bZbigniew Jędrzejewski-Szmek This functionality is useful to ensure that, regardless of how
b5c7d097ec7d16facaaeb0da5ba2abb2b1fc230bZbigniew Jędrzejewski-Szmek many VTs are allocated by other subsystems, one login
3b5cfcdb580f5b766ff7fb1a2839bd37d74a98deZbigniew Jędrzejewski-Szmek <literal>getty</literal> is always available. Defaults to 6
3b5cfcdb580f5b766ff7fb1a2839bd37d74a98deZbigniew Jędrzejewski-Szmek (in other words, there will always be a
3b5cfcdb580f5b766ff7fb1a2839bd37d74a98deZbigniew Jędrzejewski-Szmek <literal>getty</literal> available on Alt-F6.). When set to 0,
3b5cfcdb580f5b766ff7fb1a2839bd37d74a98deZbigniew Jędrzejewski-Szmek VT reservation is disabled.</para></listitem>
3b5cfcdb580f5b766ff7fb1a2839bd37d74a98deZbigniew Jędrzejewski-Szmek </varlistentry>
3b5cfcdb580f5b766ff7fb1a2839bd37d74a98deZbigniew Jędrzejewski-Szmek
3b5cfcdb580f5b766ff7fb1a2839bd37d74a98deZbigniew Jędrzejewski-Szmek <varlistentry>
3b5cfcdb580f5b766ff7fb1a2839bd37d74a98deZbigniew Jędrzejewski-Szmek <term><varname>KillUserProcesses=</varname></term>
3b5cfcdb580f5b766ff7fb1a2839bd37d74a98deZbigniew Jędrzejewski-Szmek
3b5cfcdb580f5b766ff7fb1a2839bd37d74a98deZbigniew Jędrzejewski-Szmek <listitem><para>Takes a boolean argument. Configures whether
3b5cfcdb580f5b766ff7fb1a2839bd37d74a98deZbigniew Jędrzejewski-Szmek the processes of a user should be killed when the user
3b5cfcdb580f5b766ff7fb1a2839bd37d74a98deZbigniew Jędrzejewski-Szmek completely logs out (i.e. after the user's last session
3b5cfcdb580f5b766ff7fb1a2839bd37d74a98deZbigniew Jędrzejewski-Szmek ended). Defaults to <literal>no</literal>.</para>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <para>Note that setting <varname>KillUserProcesses=1</varname>
dd2b607b7d1ce355e93f9f71cd256ec20b8ae9c4Thomas Hindoe Paaboel Andersen will break tools like
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <citerefentry project='die-net'><refentrytitle>screen</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para></listitem>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk </varlistentry>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <varlistentry>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <term><varname>KillOnlyUsers=</varname></term>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <term><varname>KillExcludeUsers=</varname></term>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <listitem><para>These settings take space-separated lists of
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk usernames that influence the effect of
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <varname>KillUserProcesses=</varname>. If not empty, only
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk processes of users listed in <varname>KillOnlyUsers=</varname>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk will be killed when they log out entirely. Processes of users
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk listed in <varname>KillExcludeUsers=</varname> are excluded
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk from being killed. <varname>KillExcludeUsers=</varname>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk defaults to <literal>root</literal> and takes precedence over
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <varname>KillOnlyUsers=</varname>, which defaults to the empty
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk list.</para></listitem>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk </varlistentry>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <varlistentry>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <term><varname>IdleAction=</varname></term>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <listitem><para>Configures the action to take when the system
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk is idle. Takes one of
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <literal>ignore</literal>,
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <literal>poweroff</literal>,
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <literal>reboot</literal>,
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <literal>halt</literal>,
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <literal>kexec</literal>,
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <literal>suspend</literal>,
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <literal>hibernate</literal>,
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <literal>hybrid-sleep</literal>, and
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <literal>lock</literal>.
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk Defaults to <literal>ignore</literal>.</para>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <para>Note that this requires that user sessions correctly
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk report the idle status to the system. The system will execute
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk the action after all sessions report that they are idle, no
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk idle inhibitor lock is active, and subsequently, the time
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk configured with <varname>IdleActionSec=</varname> (see below)
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk has expired.</para>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk </listitem>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk </varlistentry>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <varlistentry>
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt <term><varname>IdleActionSec=</varname></term>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <listitem><para>Configures the delay after which the action
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk configured in <varname>IdleAction=</varname> (see above) is
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk taken after the system is idle.</para></listitem>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk </varlistentry>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <varlistentry>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <term><varname>InhibitDelayMaxSec=</varname></term>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <listitem><para>Specifies the maximum time a system shutdown
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek or sleep request is delayed due to an inhibitor lock of type
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <literal>delay</literal> being active before the inhibitor is
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek ignored and the operation executes anyway. Defaults to
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk 5.</para></listitem>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk </varlistentry>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek <varlistentry>
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek <term><varname>HandlePowerKey=</varname></term>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <term><varname>HandleSuspendKey=</varname></term>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <term><varname>HandleHibernateKey=</varname></term>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <term><varname>HandleLidSwitch=</varname></term>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <term><varname>HandleLidSwitchDocked=</varname></term>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <listitem><para>Controls whether logind shall handle the
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk system power and sleep keys and the lid switch to trigger
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk actions such as system power-off or suspend. Can be one of
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <literal>ignore</literal>,
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <literal>poweroff</literal>,
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <literal>reboot</literal>,
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <literal>halt</literal>,
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <literal>kexec</literal>,
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <literal>suspend</literal>,
fa13e4a78487971a5093db3fdc61cad224d47c16Zbigniew Jędrzejewski-Szmek <literal>hibernate</literal>,
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <literal>hybrid-sleep</literal>, and
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <literal>lock</literal>.
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk If <literal>ignore</literal>, logind will never handle these
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk keys. If <literal>lock</literal>, all running sessions will be
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk screen-locked; otherwise, the specified action will be taken
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk in the respective event. Only input devices with the
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <literal>power-switch</literal> udev tag will be watched for
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk key/lid switch events. <varname>HandlePowerKey=</varname>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk defaults to <literal>poweroff</literal>.
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <varname>HandleSuspendKey=</varname> and
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <varname>HandleLidSwitch=</varname> default to
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <literal>suspend</literal>.
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <varname>HandleLidSwitchDocked=</varname> defaults to
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <literal>ignore</literal>.
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <varname>HandleHibernateKey=</varname> defaults to
fa13e4a78487971a5093db3fdc61cad224d47c16Zbigniew Jędrzejewski-Szmek <literal>hibernate</literal>. If the system is inserted in a
fa13e4a78487971a5093db3fdc61cad224d47c16Zbigniew Jędrzejewski-Szmek docking station, or if more than one display is connected, the
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek action specified by <varname>HandleLidSwitchDocked=</varname>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk occurs; otherwise the <varname>HandleLidSwitch=</varname>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk action occurs.</para></listitem>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk </varlistentry>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <varlistentry>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <term><varname>PowerKeyIgnoreInhibited=</varname></term>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <term><varname>SuspendKeyIgnoreInhibited=</varname></term>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <term><varname>HibernateKeyIgnoreInhibited=</varname></term>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <term><varname>LidSwitchIgnoreInhibited=</varname></term>
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk <listitem><para>Controls whether actions triggered by the
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek power and sleep keys and the lid switch are subject to
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk inhibitor locks. These settings take boolean arguments. If
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek <literal>no</literal>, the inhibitor locks taken by
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk applications in order to block the requested operation are
aa1169774bbd61761965d826fe36bd071ec78656Johan Ouwerkerk respected. If <literal>yes</literal>, the requested operation
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek is executed in any case.
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek <varname>PowerKeyIgnoreInhibited=</varname>,
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek <varname>SuspendKeyIgnoreInhibited=</varname> and
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek <varname>HibernateKeyIgnoreInhibited=</varname> default to
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek <literal>no</literal>.
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek <varname>LidSwitchIgnoreInhibited=</varname> defaults to
ecca17f6eec83b58f39ff5dc7894044c524ddf41Kay Sievers <literal>yes</literal>. This means that the lid switch does
ecca17f6eec83b58f39ff5dc7894044c524ddf41Kay Sievers not respect suspend blockers by default, but the power and
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek sleep keys do. </para></listitem>
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek </varlistentry>
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek <varlistentry>
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek <term><varname>HoldoffTimeoutSec=</varname></term>
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek <listitem><para>Specifies the timeout after system startup or
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek system resume in which systemd will hold off on reacting to
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek lid events. This is required for the system to properly
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek detect any hotplugged devices so systemd can ignore lid events
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek if external monitors, or docks, are connected. If set to 0,
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek systemd will always react immediately, possibly before the
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek kernel fully probed all hotplugged devices. This is safe, as
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek long as you do not care for systemd to account for devices
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek that have been plugged or unplugged while the system was off.
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek Defaults to 30s.</para></listitem>
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek </varlistentry>
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek
20089f95e83dd6a3e9238b3448ce2e55536184ffZbigniew Jędrzejewski-Szmek <varlistentry>
ecca17f6eec83b58f39ff5dc7894044c524ddf41Kay Sievers <term><varname>RuntimeDirectorySize=</varname></term>
ecca17f6eec83b58f39ff5dc7894044c524ddf41Kay Sievers
ecca17f6eec83b58f39ff5dc7894044c524ddf41Kay Sievers <listitem><para>Sets the size limit on the
ecca17f6eec83b58f39ff5dc7894044c524ddf41Kay Sievers <varname>$XDG_RUNTIME_DIR</varname> runtime directory for each
ecca17f6eec83b58f39ff5dc7894044c524ddf41Kay Sievers user who logs in. Takes a size in bytes, optionally suffixed
2cc8d9731aff3e401bc6a5a243f20fec123d48e6Zbigniew Jędrzejewski-Szmek with the usual K, G, M, and T suffixes, to the base 1024
2cc8d9731aff3e401bc6a5a243f20fec123d48e6Zbigniew Jędrzejewski-Szmek (IEC). Alternatively, a numerical percentage suffixed by
2cc8d9731aff3e401bc6a5a243f20fec123d48e6Zbigniew Jędrzejewski-Szmek <literal>%</literal> may be specified, which sets the size
2cc8d9731aff3e401bc6a5a243f20fec123d48e6Zbigniew Jędrzejewski-Szmek limit relative to the amount of physical RAM. Defaults to 10%.
2cc8d9731aff3e401bc6a5a243f20fec123d48e6Zbigniew Jędrzejewski-Szmek Note that this size is a safety limit only. As each runtime
2cc8d9731aff3e401bc6a5a243f20fec123d48e6Zbigniew Jędrzejewski-Szmek directory is a tmpfs file system, it will only consume as much
1f35347af0524ca673b2b4fde09c348aecf62666Kay Sievers memory as is needed.</para></listitem>
702f64b93cb215d43f673dd4b2f3646b879c566eZbigniew Jędrzejewski-Szmek </varlistentry>
702f64b93cb215d43f673dd4b2f3646b879c566eZbigniew Jędrzejewski-Szmek
702f64b93cb215d43f673dd4b2f3646b879c566eZbigniew Jędrzejewski-Szmek <varlistentry>
702f64b93cb215d43f673dd4b2f3646b879c566eZbigniew Jędrzejewski-Szmek <term><varname>UserTasksMax=</varname></term>
702f64b93cb215d43f673dd4b2f3646b879c566eZbigniew Jędrzejewski-Szmek
ecca17f6eec83b58f39ff5dc7894044c524ddf41Kay Sievers <listitem><para>Sets the maximum number of OS tasks each user
ecca17f6eec83b58f39ff5dc7894044c524ddf41Kay Sievers may run concurrently. This controls the
ecca17f6eec83b58f39ff5dc7894044c524ddf41Kay Sievers <varname>TasksMax=</varname> setting of the per-user slice
909f413d3c572baadf9b13e36e1e90beba42af86Zbigniew Jędrzejewski-Szmek unit, see
909f413d3c572baadf9b13e36e1e90beba42af86Zbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.resource-control</refentrytitle><manvolnum>5</manvolnum></citerefentry>
909f413d3c572baadf9b13e36e1e90beba42af86Zbigniew Jędrzejewski-Szmek for details. Defaults to 12288 (12K).</para></listitem>
909f413d3c572baadf9b13e36e1e90beba42af86Zbigniew Jędrzejewski-Szmek </varlistentry>
909f413d3c572baadf9b13e36e1e90beba42af86Zbigniew Jędrzejewski-Szmek
909f413d3c572baadf9b13e36e1e90beba42af86Zbigniew Jędrzejewski-Szmek <varlistentry>
76318284fc970b30e9dc4c079960807345331dadLennart Poettering <term><varname>RemoveIPC=</varname></term>
76318284fc970b30e9dc4c079960807345331dadLennart Poettering
76318284fc970b30e9dc4c079960807345331dadLennart Poettering <listitem><para>Controls whether System V and POSIX IPC objects belonging to the user shall be removed when the
76318284fc970b30e9dc4c079960807345331dadLennart Poettering 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 <literal>yes</literal>.</para></listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>See Also</title>
<para>
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd-logind.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
<citerefentry><refentrytitle>loginctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd-system.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>
</para>
</refsect1>
</refentry>