[thirdparty/systemd.git] / man / logind.conf.xml

<?xml version='1.0'?> <!--*-nxml-*-->
<?xml-stylesheet type="text/xsl" href="http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
        "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">

<!--
  This file is part of systemd.

  Copyright 2010 Lennart Poettering

  systemd is free software; you can redistribute it and/or modify it
  under the terms of the GNU Lesser General Public License as published by
  the Free Software Foundation; either version 2.1 of the License, or
  (at your option) any later version.

  systemd is distributed in the hope that it will be useful, but
  WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  Lesser General Public License for more details.

  You should have received a copy of the GNU Lesser General Public License
  along with systemd; If not, see <http://www.gnu.org/licenses/>.
-->

<refentry id="logind.conf" conditional='ENABLE_LOGIND'
          xmlns:xi="http://www.w3.org/2001/XInclude">
        <refentryinfo>
                <title>logind.conf</title>
                <productname>systemd</productname>

                <authorgroup>
                        <author>
                                <contrib>Developer</contrib>
                                <firstname>Lennart</firstname>
                                <surname>Poettering</surname>
                                <email>lennart@poettering.net</email>
                        </author>
                </authorgroup>
        </refentryinfo>

        <refmeta>
                <refentrytitle>logind.conf</refentrytitle>
                <manvolnum>5</manvolnum>
        </refmeta>

        <refnamediv>
                <refname>logind.conf</refname>
                <refname>logind.conf.d</refname>
                <refpurpose>Login manager configuration files</refpurpose>
        </refnamediv>

        <refsynopsisdiv>
                <para><filename>/etc/systemd/logind.conf</filename></para>
                <para><filename>/etc/systemd/logind.conf.d/*.conf</filename></para>
                <para><filename>/run/systemd/logind.conf.d/*.conf</filename></para>
                <para><filename>/usr/lib/systemd/logind.conf.d/*.conf</filename></para>
        </refsynopsisdiv>

        <refsect1>
                <title>Description</title>

                <para>These files configure various parameters of the systemd login manager, <citerefentry><refentrytitle>systemd-logind.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
        </refsect1>

        <xi:include href="standard-conf.xml" xpointer="confd" />
        <xi:include href="standard-conf.xml" xpointer="conf" />

        <refsect1>
                <title>Options</title>

                <para>All options are configured in the
                <literal>[Login]</literal> section:</para>

                <variablelist>

                        <varlistentry>
                                <term><varname>NAutoVTs=</varname></term>

                                <listitem><para>Takes a positive
                                integer. Configures how many virtual
                                terminals (VTs) to allocate by default
                                that, when switched to and are
                                previously unused,
                                <literal>autovt</literal> services are
                                automatically spawned on. These
                                services are instantiated from the
                                template unit
                                <filename>autovt@.service</filename>
                                for the respective VT TTY name,
                                for example, <filename>autovt@tty4.service</filename>. By
                                default,
                                <filename>autovt@.service</filename>
                                is linked to
                                <filename>getty@.service</filename>.
                                In other words, login prompts are started
                                dynamically as the user switches to
                                unused virtual terminals. Hence, this
                                parameter controls how many login
                                <literal>gettys</literal> 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 <varname>ReserveVT=</varname> is
                                always subject to this kind of
                                activation, even if it is not one of
                                the VTs configured with the
                                <varname>NAutoVTs=</varname>
                                directive. Defaults to 6. When set to
                                0, automatic spawning of
                                <literal>autovt</literal> services is
                                disabled.</para></listitem>
                        </varlistentry>

                        <varlistentry>
                                <term><varname>ReserveVT=</varname></term>

                                <listitem><para>Takes a positive
                                integer. Identifies one
                                virtual terminal that shall
                                unconditionally be reserved for
                                <filename>autovt@.service</filename>
                                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 of how many VTs are allocated
                                by other subsystems, one login
                                <literal>getty</literal> is always
                                available. Defaults to 6 (in other
                                words, there will always be a
                                <literal>getty</literal> available on
                                Alt-F6.). When set to 0, VT
                                reservation is
                                disabled.</para></listitem>
                        </varlistentry>

                        <varlistentry>
                                <term><varname>KillUserProcesses=</varname></term>

                                <listitem><para>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
                                <literal>no</literal>.</para>

                                <para>Note that setting
                                <varname>KillUserProcesses=1</varname>
                                will break tools like
                                <citerefentry><refentrytitle>screen</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para></listitem>
                        </varlistentry>

                        <varlistentry>
                                <term><varname>KillOnlyUsers=</varname></term>
                                <term><varname>KillExcludeUsers=</varname></term>

                                <listitem><para>These settings take
                                space-separated lists of usernames
                                that influence the effect of
                                <varname>KillUserProcesses=</varname>. If
                                not empty, only processes of users
                                listed in
                                <varname>KillOnlyUsers=</varname> will
                                be killed when they log out
                                entirely. Processes of users listed in
                                <varname>KillExcludeUsers=</varname>
                                are excluded from being
                                killed. <varname>KillExcludeUsers=</varname>
                                defaults to <literal>root</literal>
                                and takes precedence over
                                <varname>KillOnlyUsers=</varname>,
                                which defaults to the empty list.</para></listitem>
                        </varlistentry>

                        <varlistentry>
                                <term><varname>IdleAction=</varname></term>

                                <listitem><para>Configures the action
                                to take when the system is idle. Takes
                                one of <literal>ignore</literal>,
                                <literal>poweroff</literal>,
                                <literal>reboot</literal>,
                                <literal>halt</literal>,
                                <literal>kexec</literal>,
                                <literal>suspend</literal>,
                                <literal>hibernate</literal>,
                                <literal>hybrid-sleep</literal>, and
                                <literal>lock</literal>. Defaults to
                                <literal>ignore</literal>.</para>

                                <para>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 <varname>IdleActionSec=</varname>
                                (see below) has expired.</para>
                                </listitem>
                        </varlistentry>

                        <varlistentry>
                                <term><varname>IdleActionSec=</varname></term>

                                <listitem><para>Configures the delay
                                after which the action configured in
                                <varname>IdleAction=</varname> (see
                                above) is taken after the system is
                                idle.</para></listitem>
                        </varlistentry>

                        <varlistentry>
                                <term><varname>InhibitDelayMaxSec=</varname></term>

                                <listitem><para>Specifies the maximum
                                time a system shutdown or sleep
                                request is delayed due to an inhibitor
                                lock of type <literal>delay</literal>
                                being active before the inhibitor is
                                ignored and the operation executes
                                anyway. Defaults to
                                5.</para></listitem>
                        </varlistentry>

                        <varlistentry>
                                <term><varname>HandlePowerKey=</varname></term>
                                <term><varname>HandleSuspendKey=</varname></term>
                                <term><varname>HandleHibernateKey=</varname></term>
                                <term><varname>HandleLidSwitch=</varname></term>
                                <term><varname>HandleLidSwitchDocked=</varname></term>

                                <listitem><para>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
                                <literal>ignore</literal>,
                                <literal>poweroff</literal>,
                                <literal>reboot</literal>,
                                <literal>halt</literal>,
                                <literal>kexec</literal>,
                                <literal>suspend</literal>,
                                <literal>hibernate</literal>,
                                <literal>hybrid-sleep</literal>, and
                                <literal>lock</literal>. If
                                <literal>ignore</literal>, logind will
                                never handle these keys. If
                                <literal>lock</literal>, all running
                                sessions will be screen-locked;
                                otherwise, the specified action will
                                be taken in the respective event. Only
                                input devices with the
                                <literal>power-switch</literal> udev
                                tag will be watched for key/lid switch
                                events. <varname>HandlePowerKey=</varname>
                                defaults to
                                <literal>poweroff</literal>.
                                <varname>HandleSuspendKey=</varname>
                                and
                                <varname>HandleLidSwitch=</varname>
                                default to <literal>suspend</literal>.
                                <varname>HandleLidSwitchDocked=</varname>
                                defaults to <literal>ignore</literal>.
                                <varname>HandleHibernateKey=</varname>
                                defaults to
                                <literal>hibernate</literal>. If the
                                system is inserted in a docking station,
                                or if more than one display is connected,
                                the action specified by
                                <varname>HandleLidSwitchDocked=</varname>
                                occurs; otherwise the
                                <varname>HandleLidSwitch=</varname>
                                action occurs.</para></listitem>
                        </varlistentry>

                        <varlistentry>
                                <term><varname>PowerKeyIgnoreInhibited=</varname></term>
                                <term><varname>SuspendKeyIgnoreInhibited=</varname></term>
                                <term><varname>HibernateKeyIgnoreInhibited=</varname></term>
                                <term><varname>LidSwitchIgnoreInhibited=</varname></term>

                                <listitem><para>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
                                <literal>no</literal>, the inhibitor
                                locks taken by applications in order
                                to block the requested operation are
                                respected. If <literal>yes</literal>,
                                the requested operation is executed in
                                any
                                case. <varname>PowerKeyIgnoreInhibited=</varname>,
                                <varname>SuspendKeyIgnoreInhibited=</varname>
                                and
                                <varname>HibernateKeyIgnoreInhibited=</varname>
                                default to <literal>no</literal>.
                                <varname>LidSwitchIgnoreInhibited=</varname>
                                defaults to
                                <literal>yes</literal>. This means
                                that the lid switch does not respect
                                suspend blockers by default, but the
                                power and sleep keys do.
                                </para></listitem>
                        </varlistentry>

                        <varlistentry>
                                <term><varname>RuntimeDirectorySize=</varname></term>

                                <listitem><para>Sets the size limit on
                                the
                                <varname>$XDG_RUNTIME_DIR</varname>
                                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 <literal>%</literal>
                                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.
                                </para></listitem>
                        </varlistentry>

                        <varlistentry>
                                <term><varname>RemoveIPC=</varname></term>

                                <listitem><para>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
                                <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>
Commit	Line	Data
8fa365e5 LP	1	<?xml version='1.0'?> <!---nxml--->
	2	<?xml-stylesheet type="text/xsl" href="http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl"?>
	3	<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
	4	"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
	5
	6	<!--
	7	This file is part of systemd.
	8
	9	Copyright 2010 Lennart Poettering
	10
	11	systemd is free software; you can redistribute it and/or modify it
5430f7f2 LP	12	under the terms of the GNU Lesser General Public License as published by
5430f7f2 LP	13	the Free Software Foundation; either version 2.1 of the License, or
8fa365e5 LP	14	(at your option) any later version.
	15
	16	systemd is distributed in the hope that it will be useful, but
	17	WITHOUT ANY WARRANTY; without even the implied warranty of
	18	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
5430f7f2	19	Lesser General Public License for more details.
8fa365e5	20
5430f7f2	21	You should have received a copy of the GNU Lesser General Public License
8fa365e5 LP	22	along with systemd; If not, see <http://www.gnu.org/licenses/>.
	23	-->
	24
d3fae78f JT	25	<refentry id="logind.conf" conditional='ENABLE_LOGIND'
d3fae78f JT	26	xmlns:xi="http://www.w3.org/2001/XInclude">
8fa365e5	27	<refentryinfo>
18b754d3	28	<title>logind.conf</title>
8fa365e5 LP	29	<productname>systemd</productname>
	30
	31	<authorgroup>
	32	<author>
	33	<contrib>Developer</contrib>
	34	<firstname>Lennart</firstname>
	35	<surname>Poettering</surname>
	36	<email>lennart@poettering.net</email>
	37	</author>
	38	</authorgroup>
	39	</refentryinfo>
	40
	41	<refmeta>
18b754d3	42	<refentrytitle>logind.conf</refentrytitle>
8fa365e5 LP	43	<manvolnum>5</manvolnum>
	44	</refmeta>
	45
	46	<refnamediv>
18b754d3	47	<refname>logind.conf</refname>
02b75c9e	48	<refname>logind.conf.d</refname>
e8461023	49	<refpurpose>Login manager configuration files</refpurpose>
8fa365e5 LP	50	</refnamediv>
	51
	52	<refsynopsisdiv>
01cf0ca8	53	<para><filename>/etc/systemd/logind.conf</filename></para>
e8461023 JT	54	<para><filename>/etc/systemd/logind.conf.d/*.conf</filename></para>
	55	<para><filename>/run/systemd/logind.conf.d/*.conf</filename></para>
	56	<para><filename>/usr/lib/systemd/logind.conf.d/*.conf</filename></para>
8fa365e5 LP	57	</refsynopsisdiv>
	58
	59	<refsect1>
	60	<title>Description</title>
	61
e8461023	62	<para>These files configure various parameters of the systemd login manager, <citerefentry><refentrytitle>systemd-logind.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
8fa365e5 LP	63	</refsect1>
8fa365e5 LP	64
d3fae78f JT	65	<xi:include href="standard-conf.xml" xpointer="confd" />
	66	<xi:include href="standard-conf.xml" xpointer="conf" />
	67
8fa365e5 LP	68	<refsect1>
	69	<title>Options</title>
	70
	71	<para>All options are configured in the
	72	<literal>[Login]</literal> section:</para>
	73
	74	<variablelist>
	75
	76	<varlistentry>
	77	<term><varname>NAutoVTs=</varname></term>
	78
	79	<listitem><para>Takes a positive
64e441d0	80	integer. Configures how many virtual
98a77df5	81	terminals (VTs) to allocate by default
a3f6aa26 JSJ	82	that, when switched to and are
a3f6aa26 JSJ	83	previously unused,
64e441d0 LP	84	<literal>autovt</literal> services are
	85	automatically spawned on. These
	86	services are instantiated from the
98a77df5	87	template unit
8fa365e5	88	<filename>autovt@.service</filename>
98a77df5	89	for the respective VT TTY name,
24fe021b	90	for example, <filename>autovt@tty4.service</filename>. By
409dee2e	91	default,
8fa365e5 LP	92	<filename>autovt@.service</filename>
8fa365e5 LP	93	is linked to
24fe021b JSJ	94	<filename>getty@.service</filename>.
24fe021b JSJ	95	In other words, login prompts are started
8fa365e5	96	dynamically as the user switches to
98a77df5 LP	97	unused virtual terminals. Hence, this
	98	parameter controls how many login
	99	<literal>gettys</literal> are
	100	available on the VTs. If a VT is
	101	already used by some other subsystem
24fe021b	102	(for example, a graphical login), this
98a77df5 LP	103	kind of activation will not be
	104	attempted. Note that the VT configured
	105	in <varname>ReserveVT=</varname> is
	106	always subject to this kind of
	107	activation, even if it is not one of
24fe021b	108	the VTs configured with the
98a77df5 LP	109	<varname>NAutoVTs=</varname>
98a77df5 LP	110	directive. Defaults to 6. When set to
8fa365e5 LP	111	0, automatic spawning of
8fa365e5 LP	112	<literal>autovt</literal> services is
409dee2e	113	disabled.</para></listitem>
98a77df5 LP	114	</varlistentry>
	115
	116	<varlistentry>
	117	<term><varname>ReserveVT=</varname></term>
	118
	119	<listitem><para>Takes a positive
24fe021b	120	integer. Identifies one
98a77df5 LP	121	virtual terminal that shall
	122	unconditionally be reserved for
	123	<filename>autovt@.service</filename>
	124	activation (see above). The VT
	125	selected with this option will be
a3f6aa26	126	marked busy unconditionally, so that no
98a77df5	127	other subsystem will allocate it. This
24fe021b	128	functionality is useful to ensure that,
a3f6aa26	129	regardless of how many VTs are allocated
409dee2e	130	by other subsystems, one login
98a77df5	131	<literal>getty</literal> is always
a3f6aa26 JSJ	132	available. Defaults to 6 (in other
a3f6aa26 JSJ	133	words, there will always be a
98a77df5 LP	134	<literal>getty</literal> available on
	135	Alt-F6.). When set to 0, VT
	136	reservation is
8fa365e5 LP	137	disabled.</para></listitem>
	138	</varlistentry>
	139
	140	<varlistentry>
	141	<term><varname>KillUserProcesses=</varname></term>
	142
	143	<listitem><para>Takes a boolean
	144	argument. Configures whether the
	145	processes of a user should be killed
24fe021b JSJ	146	when the user completely logs out (i.e. after
24fe021b JSJ	147	the user's last session ended). Defaults to
405e0255 LP	148	<literal>no</literal>.</para>
	149
	150	<para>Note that setting
	151	<varname>KillUserProcesses=1</varname>
	152	will break tools like
	153	<citerefentry><refentrytitle>screen</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para></listitem>
	154	</varlistentry>
	155
	156	<varlistentry>
	157	<term><varname>KillOnlyUsers=</varname></term>
	158	<term><varname>KillExcludeUsers=</varname></term>
	159
	160	<listitem><para>These settings take
	161	space-separated lists of usernames
	162	that influence the effect of
	163	<varname>KillUserProcesses=</varname>. If
	164	not empty, only processes of users
	165	listed in
	166	<varname>KillOnlyUsers=</varname> will
	167	be killed when they log out
	168	entirely. Processes of users listed in
	169	<varname>KillExcludeUsers=</varname>
	170	are excluded from being
	171	killed. <varname>KillExcludeUsers=</varname>
	172	defaults to <literal>root</literal>
	173	and takes precedence over
	174	<varname>KillOnlyUsers=</varname>,
	175	which defaults to the empty list.</para></listitem>
8fa365e5 LP	176	</varlistentry>
8fa365e5 LP	177
c29e0646 LP	178	<varlistentry>
	179	<term><varname>IdleAction=</varname></term>
	180
	181	<listitem><para>Configures the action
	182	to take when the system is idle. Takes
	183	one of <literal>ignore</literal>,
	184	<literal>poweroff</literal>,
	185	<literal>reboot</literal>,
	186	<literal>halt</literal>,
	187	<literal>kexec</literal>,
	188	<literal>suspend</literal>,
	189	<literal>hibernate</literal>,
24fe021b	190	<literal>hybrid-sleep</literal>, and
c29e0646 LP	191	<literal>lock</literal>. Defaults to
	192	<literal>ignore</literal>.</para>
	193
	194	<para>Note that this requires that
	195	user sessions correctly report the
	196	idle status to the system. The system
	197	will execute the action after all
a3f6aa26 JSJ	198	sessions report that they are idle,
	199	no idle inhibitor lock is active,
	200	and subsequently, the time configured
c29e0646	201	with <varname>IdleActionSec=</varname>
a3f6aa26	202	(see below) has expired.</para>
c29e0646 LP	203	</listitem>
	204	</varlistentry>
	205
	206	<varlistentry>
	207	<term><varname>IdleActionSec=</varname></term>
	208
	209	<listitem><para>Configures the delay
	210	after which the action configured in
	211	<varname>IdleAction=</varname> (see
	212	above) is taken after the system is
	213	idle.</para></listitem>
	214	</varlistentry>
	215
eecd1362 LP	216	<varlistentry>
	217	<term><varname>InhibitDelayMaxSec=</varname></term>
	218
	219	<listitem><para>Specifies the maximum
4943c1c9 LP	220	time a system shutdown or sleep
	221	request is delayed due to an inhibitor
	222	lock of type <literal>delay</literal>
a3f6aa26 JSJ	223	being active before the inhibitor is
a3f6aa26 JSJ	224	ignored and the operation executes
4943c1c9	225	anyway. Defaults to
24fe021b	226	5.</para></listitem>
069cfc85	227	</varlistentry>
eecd1362	228
069cfc85 LP	229	<varlistentry>
069cfc85 LP	230	<term><varname>HandlePowerKey=</varname></term>
8e7fd6ad LP	231	<term><varname>HandleSuspendKey=</varname></term>
8e7fd6ad LP	232	<term><varname>HandleHibernateKey=</varname></term>
069cfc85	233	<term><varname>HandleLidSwitch=</varname></term>
3c56cab4	234	<term><varname>HandleLidSwitchDocked=</varname></term>
069cfc85 LP	235
	236	<listitem><para>Controls whether
	237	logind shall handle the system power
	238	and sleep keys and the lid switch to
beaafb2e LP	239	trigger actions such as system
	240	power-off or suspend. Can be one of
	241	<literal>ignore</literal>,
	242	<literal>poweroff</literal>,
	243	<literal>reboot</literal>,
	244	<literal>halt</literal>,
6524990f	245	<literal>kexec</literal>,
4e84ae7e	246	<literal>suspend</literal>,
7654b2c2	247	<literal>hibernate</literal>,
24fe021b	248	<literal>hybrid-sleep</literal>, and
7654b2c2	249	<literal>lock</literal>. If
e9dd9f95	250	<literal>ignore</literal>, logind will
7654b2c2	251	never handle these keys. If
e9dd9f95	252	<literal>lock</literal>, all running
6a79c586 LP	253	sessions will be screen-locked;
	254	otherwise, the specified action will
	255	be taken in the respective event. Only
	256	input devices with the
6de0e0e5	257	<literal>power-switch</literal> udev
beaafb2e	258	tag will be watched for key/lid switch
069cfc85	259	events. <varname>HandlePowerKey=</varname>
6de0e0e5	260	defaults to
beaafb2e	261	<literal>poweroff</literal>.
8e7fd6ad LP	262	<varname>HandleSuspendKey=</varname>
8e7fd6ad LP	263	and
069cfc85	264	<varname>HandleLidSwitch=</varname>
8e7fd6ad	265	default to <literal>suspend</literal>.
3c56cab4 BW	266	<varname>HandleLidSwitchDocked=</varname>
3c56cab4 BW	267	defaults to <literal>ignore</literal>.
8e7fd6ad LP	268	<varname>HandleHibernateKey=</varname>
8e7fd6ad LP	269	defaults to
3c56cab4 BW	270	<literal>hibernate</literal>. If the
	271	system is inserted in a docking station,
	272	or if more than one display is connected,
	273	the action specified by
	274	<varname>HandleLidSwitchDocked=</varname>
	275	occurs; otherwise the
	276	<varname>HandleLidSwitch=</varname>
	277	action occurs.</para></listitem>
beaafb2e LP	278	</varlistentry>
	279
	280	<varlistentry>
	281	<term><varname>PowerKeyIgnoreInhibited=</varname></term>
8e7fd6ad LP	282	<term><varname>SuspendKeyIgnoreInhibited=</varname></term>
8e7fd6ad LP	283	<term><varname>HibernateKeyIgnoreInhibited=</varname></term>
beaafb2e LP	284	<term><varname>LidSwitchIgnoreInhibited=</varname></term>
	285
	286	<listitem><para>Controls whether
	287	actions triggered by the power and
	288	sleep keys and the lid switch are
	289	subject to inhibitor locks. These
	290	settings take boolean arguments. If
6e3157c5	291	<literal>no</literal>, the inhibitor
beaafb2e LP	292	locks taken by applications in order
beaafb2e LP	293	to block the requested operation are
6e3157c5	294	respected. If <literal>yes</literal>,
beaafb2e LP	295	the requested operation is executed in
beaafb2e LP	296	any
8e7fd6ad LP	297	case. <varname>PowerKeyIgnoreInhibited=</varname>,
8e7fd6ad LP	298	<varname>SuspendKeyIgnoreInhibited=</varname>
beaafb2e	299	and
8e7fd6ad	300	<varname>HibernateKeyIgnoreInhibited=</varname>
6e3157c5	301	default to <literal>no</literal>.
beaafb2e	302	<varname>LidSwitchIgnoreInhibited=</varname>
069cfc85	303	defaults to
beaafb2e LP	304	<literal>yes</literal>. This means
	305	that the lid switch does not respect
	306	suspend blockers by default, but the
	307	power and sleep keys do.
	308	</para></listitem>
eecd1362 LP	309	</varlistentry>
eecd1362 LP	310
1c231f56 LP	311	<varlistentry>
	312	<term><varname>RuntimeDirectorySize=</varname></term>
	313
	314	<listitem><para>Sets the size limit on
	315	the
	316	<varname>$XDG_RUNTIME_DIR</varname>
	317	runtime directory for each user who
	318	logs in. Takes a size in bytes,
24fe021b JSJ	319	optionally suffixed with the usual K, G,
	320	M, and T suffixes, to the base 1024
	321	(IEC). Alternatively, a numerical
	322	percentage suffixed by <literal>%</literal>
	323	may be specified, which sets the size
1c231f56 LP	324	limit relative to the amount of
	325	physical RAM. Defaults to 10%. Note
	326	that this size is a safety limit
	327	only. As each runtime directory is a
b8bde116	328	tmpfs file system, it will only consume
24fe021b JSJ	329	as much memory as is needed.
24fe021b JSJ	330	</para></listitem>
1c231f56 LP	331	</varlistentry>
1c231f56 LP	332
66cdd0f2 LP	333	<varlistentry>
	334	<term><varname>RemoveIPC=</varname></term>
	335
	336	<listitem><para>Controls whether
	337	System V and POSIX IPC objects
	338	belonging to the user shall be removed
24fe021b	339	when the user fully logs out. Takes a
b8bde116	340	boolean argument. If enabled, the user
66cdd0f2	341	may not consume IPC resources after
820c0958	342	the last of the user's sessions
66cdd0f2 LP	343	terminated. This covers System V
	344	semaphores, shared memory and message
	345	queues, as well as POSIX shared memory
	346	and message queues. Note that IPC
	347	objects of the root user are excluded
	348	from the effect of this
	349	setting. Defaults to
24fe021b	350	<literal>yes</literal>.</para></listitem>
66cdd0f2 LP	351	</varlistentry>
66cdd0f2 LP	352
8fa365e5 LP	353	</variablelist>
	354	</refsect1>
	355
	356	<refsect1>
	357	<title>See Also</title>
	358	<para>
	359	<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
af3bccd6	360	<citerefentry><refentrytitle>systemd-logind.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
169c4f65	361	<citerefentry><refentrytitle>loginctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
5f9cfd4c	362	<citerefentry><refentrytitle>systemd-system.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>
8fa365e5 LP	363	</para>
	364	</refsect1>
	365
	366	</refentry>