man/logind.conf.xml

   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
  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.
  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
  19   Lesser General Public License for more details.
  20
  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/>.
  23 -->
  24
  25 <refentry id="logind.conf">
  26         <refentryinfo>
  27                 <title>logind.conf</title>
  28                 <productname>systemd</productname>
  29
  30                 <authorgroup>
  31                         <author>
  32                                 <contrib>Developer</contrib>
  33                                 <firstname>Lennart</firstname>
  34                                 <surname>Poettering</surname>
  35                                 <email>lennart@poettering.net</email>
  36                         </author>
  37                 </authorgroup>
  38         </refentryinfo>
  39
  40         <refmeta>
  41                 <refentrytitle>logind.conf</refentrytitle>
  42                 <manvolnum>5</manvolnum>
  43         </refmeta>
  44
  45         <refnamediv>
  46                 <refname>logind.conf</refname>
  47                 <refpurpose>Login manager configuration file</refpurpose>
  48         </refnamediv>
  49
  50         <refsynopsisdiv>
  51                 <para><filename>logind.conf</filename></para>
  52         </refsynopsisdiv>
  53
  54         <refsect1>
  55                 <title>Description</title>
  56
  57                 <para>This files configures various parameters of the systemd login manager.</para>
  58
  59         </refsect1>
  60
  61         <refsect1>
  62                 <title>Options</title>
  63
  64                 <para>All options are configured in the
  65                 <literal>[Login]</literal> section:</para>
  66
  67                 <variablelist>
  68
  69                         <varlistentry>
  70                                 <term><varname>NAutoVTs=</varname></term>
  71
  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
  82                                 default
  83                                 <filename>autovt@.service</filename>
  84                                 is linked to
  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>
  95                         </varlistentry>
  96
  97                         <varlistentry>
  98                                 <term><varname>KillUserProcesses=</varname></term>
  99
 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>
 106                         </varlistentry>
 107
 108                         <varlistentry>
 109                                 <term><varname>KillOnlyUsers=</varname></term>
 110                                 <term><varname>KillExcludeUsers=</varname></term>
 111
 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
 117                                 listed in
 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>
 128                         </varlistentry>
 129
 130                         <varlistentry>
 131                                 <term><varname>Controllers=</varname></term>
 132                                 <term><varname>ResetControllers=</varname></term>
 133
 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
 139                                 listed in
 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>
 146                                 defaults to
 147                                 <literal>cpu</literal>.</para></listitem>
 148                         </varlistentry>
 149
 150                         <varlistentry>
 151                                 <term><varname>InhibitDelayMaxSec=</varname></term>
 152
 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
 159                                 anyway. Defaults to
 160                                 5s.</para></listitem>
 161                         </varlistentry>
 162
 163                         <varlistentry>
 164                                 <term><varname>HandlePowerKey=</varname></term>
 165                                 <term><varname>HandleSleepKey=</varname></term>
 166                                 <term><varname>HandleLidSwitch=</varname></term>
 167
 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
 182                                 otherwise. If set to
 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>
 198                                 defaults to
 199                                 <literal>no</literal>.</para></listitem>
 200                         </varlistentry>
 201
 202                 </variablelist>
 203
 204                 <para>Note that setting
 205                 <varname>KillUserProcesses=1</varname> will break tools
 206                 like
 207                 <citerefentry><refentrytitle>screen</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
 208
 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>
 217         </refsect1>
 218
 219         <refsect1>
 220                   <title>See Also</title>
 221                   <para>
 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>
 225                   </para>
 226         </refsect1>
 227
 228 </refentry>