<?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">

<refentry id="logind.conf">

<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>

<refpurpose>Login manager configuration file</refpurpose>

</refnamediv>

<refsynopsisdiv>

<para><filename>/etc/systemd/logind.conf</filename></para>

</refsynopsisdiv>

<refsect1>

<title>Description</title>

<para>This file configures various parameters of the systemd login manager <citerefentry><refentrytitle>systemd-logind.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>

</refsect1>

<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 to allocate by default that

-- when switched to --

<literal>autovt</literal> services are

automatically spawned on. These

services are instantiated from the

template

<filename>autovt@.service</filename>

with the virtual terminal TTY name,

e.g. <filename>autovt@tty4.service</filename>. By

default

<filename>autovt@.service</filename>

is linked to

<filename>getty@.service</filename>,

i.e. login prompts are started

dynamically as the user switches to

unused virtual terminals. This

parameter hence controls how many

gettys are available on the virtual

terminals. Defaults to 6. When set to

0, automatic spawning of

<literal>autovt</literal> services 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 she or he completely logs out (i.e. after

her/his last session ended). Defaults to

<literal>no</literal>.</para></listitem>

</varlistentry>

<varlistentry>

<term><varname>KillOnlyUsers=</varname></term>

<term><varname>KillExcludeUsers=</varname></term>

<listitem><para>These settings take

space separated lists of user names

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>Controllers=</varname></term>

<term><varname>ResetControllers=</varname></term>

<listitem><para>These settings control

the default control group hierarchies

users logging in are added to. When

logging in users will get private

control groups in all hierarchies

listed in

<varname>Controllers=</varname> and be

reset to the root control group in all

hierarchies listed in

<varname>ResetControllers=</varname>. <varname>Controllers=</varname>

defaults to the empty list,

<varname>ResetControllers=</varname>

defaults to

<literal>cpu</literal>.</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 it is ignored

and the operation executed

anyway. Defaults to

5s.</para></listitem>

</varlistentry>

<varlistentry>

<term><varname>HandlePowerKey=</varname></term>

<term><varname>HandleSleepKey=</varname></term>

<term><varname>HandleLidSwitch=</varname></term>

<listitem><para>Controls whether

logind shall handle the system power

and sleep keys and the lid switch to

trigger system power-off or

suspend. Can be one of

<literal>off</literal>,

<literal>no-session</literal>,

<literal>tty-session</literal>,

<literal>any-session</literal> and

<literal>always</literal>. If

<literal>off</literal> logind will

never handle these keys. If

<literal>no-session</literal> logind

will handle these keys when no user is

logged in and no inhibitor lock is

taken, and trigger a warning beep

otherwise. If set to

<literal>tty-session</literal> logind

will handle these keys if no inhibitor

lock is taken, and either no user is

logged in or the foreground session is

a text login and the only one

existing. If

<literal>any-session</literal> is set

logind will handle these keys if no

inhibitor lock is taken, and either no

user is logged in or the foreground

session is the only one existing

(regardless whether graphical or

text). If set to

<literal>always</literal> logind will

handle these keys in any case, even if

one or more users are logged in or an

inhibitor lock is taken. Only input

devices with the

<literal>power-switch</literal> udev

tag will be watched for key

events. <varname>HandlePowerKey=</varname>

defaults to

<literal>no-session</literal>.

<varname>HandleSleepKey=</varname>

defaults to

<literal>tty-session</literal>,

<varname>HandleLidSwitch=</varname>

defaults to

<literal>off</literal>.</para></listitem>

</varlistentry>

</variablelist>

<para>Note that setting

<varname>KillUserProcesses=1</varname> will break tools

like

<citerefentry><refentrytitle>screen</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>

<para>Note that <varname>KillUserProcesses=1</varname>

is a weaker version of

<varname>kill-session-processes=1</varname> which may

be configured per-service for

<citerefentry><refentrytitle>pam_systemd</refentrytitle><manvolnum>8</manvolnum></citerefentry>. The

latter kills processes of a session as soon as it

ends, the former kills processes as soon as the last

session of the user ends.</para>

</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.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>

</para>

</refsect1>

</refentry>