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">
7 This file is part of systemd.
9 Copyright 2010 Lennart Poettering
11 systemd is free software; you can redistribute it and/or modify it
12 under the terms of the GNU Lesser General Public License as published by
13 the Free Software Foundation; either version 2.1 of the License, or
14 (at your option) any later version.
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
19 Lesser General Public License for more details.
21 You should have received a copy of the GNU Lesser General Public License
22 along with systemd; If not, see <http://www.gnu.org/licenses/>.
25 <refentry id="logind.conf">
27 <title>logind.conf</title>
28 <productname>systemd</productname>
32 <contrib>Developer</contrib>
33 <firstname>Lennart</firstname>
34 <surname>Poettering</surname>
35 <email>lennart@poettering.net</email>
41 <refentrytitle>logind.conf</refentrytitle>
42 <manvolnum>5</manvolnum>
46 <refname>logind.conf</refname>
47 <refpurpose>Login manager configuration file</refpurpose>
51 <para><filename>logind.conf</filename></para>
55 <title>Description</title>
57 <para>This files configures various parameters of the systemd login manager.</para>
62 <title>Options</title>
64 <para>All options are configured in the
65 <literal>[Login]</literal> section:</para>
70 <term><varname>NAutoVTs=</varname></term>
72 <listitem><para>Takes a positive
73 integer. How many virtual terminals to
74 allocate by default and when switched
75 to autospawn <literal>autovt</literal>
76 services on (if they are otherwise
77 unused). These services are
78 instantiated from a template of
79 <filename>autovt@.service</filename>
80 with the virtual terminal TTY name,
81 e.g. <filename>autovt@tty4.service</filename>. By
83 <filename>autovt@.service</filename>
85 <filename>getty@.service</filename>,
86 i.e. login prompts are started
87 dynamically as the user switches to
88 unused virtual terminals, and this
89 parameter hence controls how many
90 gettys are available on the virtual
91 terminals. Defaults to 6. When set to
92 0, automatic spawning of
93 <literal>autovt</literal> services is
94 disabled.</para></listitem>
98 <term><varname>KillUserProcesses=</varname></term>
100 <listitem><para>Takes a boolean
101 argument. Configures whether the
102 processes of a user should be killed
103 when she or he completely logs out (i.e. after
104 her/his last session ended). Defaults to
105 <literal>no</literal>.</para></listitem>
109 <term><varname>KillOnlyUsers=</varname></term>
110 <term><varname>KillExcludeUsers=</varname></term>
112 <listitem><para>These settings take
113 space separated lists of user names
114 that influence the effect of
115 <varname>KillUserProcesses=</varname>. If
116 not empty only processes of users
118 <varname>KillOnlyUsers</varname> will
119 be killed when they log out
120 entirely. Processes of users listed in
121 <varname>KillExcludeUsers=</varname>
122 are excluded from being
123 killed. <varname>KillExcludeUsers=</varname>
124 defaults to <literal>root</literal>
125 and takes precedence over
126 <varname>KillOnlyUsers=</varname>
127 which defaults to the empty list.</para></listitem>
131 <term><varname>Controllers=</varname></term>
132 <term><varname>ResetControllers=</varname></term>
134 <listitem><para>These settings control
135 the default control group hierarchies
136 users logging are added to. When
137 logging in users will get private
138 control groups in all hierarchies
140 <varname>Controllers=</varname> and be
141 reset to the root control group in all
142 hierarchies listed in
143 <varname>ResetControllers=</varname>. <varname>Controllers=</varname>
144 defaults to the empty list,
145 <varname>ResetControllers=</varname>
147 <literal>cpu</literal>.</para></listitem>
151 <term><varname>InhibitDelayMaxSec=</varname></term>
153 <listitem><para>Specifies the maximum
154 time a system shutdown or sleep
155 request is delayed due to an inhibitor
156 lock of type <literal>delay</literal>
157 being taken before it is ignored and
158 the operation executed
160 5s.</para></listitem>
164 <term><varname>HandlePowerKey=</varname></term>
165 <term><varname>HandleSleepKey=</varname></term>
166 <term><varname>HandleLidSwitch=</varname></term>
168 <listitem><para>Controls whether
169 logind shall handle the system power
170 and sleep keys and the lid switch to
171 trigger system power-off or
172 suspend. Can be one of
173 <literal>no</literal>,
174 <literal>yes</literal> and
175 <literal>always</literal>. If
176 <literal>no</literal> logind will
177 never handle these keys. If
178 <literal>yes</literal> logind will
179 handle these keys when no user is
180 logged in and no inhibitor lock is
181 taken, and trigger a warnig beep
183 <literal>always</literal> logind will
184 handle these keys even if a user is
185 logged in or an inhibitor lock is
186 taken. In all cases logind will not
187 handle these keys if a graphical
188 session is in the foreground under the
189 assumption that the graphical session
190 will handle these keys
191 internally. Only input devices with
192 the <literal>power-switch</literal>
193 udev tag will be watched for key
194 events. <varname>HandlePowerKey=</varname>
195 and <varname>HandleSleepKey=</varname>
196 default to <literal>yes</literal>,
197 <varname>HandleLidSwitch=</varname>
199 <literal>no</literal>.</para></listitem>
204 <para>Note that setting
205 <varname>KillUserProcesses=1</varname> will break tools
207 <citerefentry><refentrytitle>screen</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
209 <para>Note that <varname>KillUserProcesses=1</varname>
210 is a weaker version of
211 <varname>kill-session-processes=1</varname> which may
212 be configured per-service for
213 <citerefentry><refentrytitle>pam_systemd</refentrytitle><manvolnum>8</manvolnum></citerefentry>. The
214 latter kills processes of a session as soon as it
215 ends, the former kills processes as soon as the last
216 session of the user ends.</para>
220 <title>See Also</title>
222 <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
223 <citerefentry><refentrytitle>loginctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
224 <citerefentry><refentrytitle>systemd.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>