man/systemd-logind.conf.5

   1 '\" t
   2 .\"     Title: systemd-logind.conf
   3 .\"    Author: Lennart Poettering <lennart@poettering.net>
   4 .\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
   5 .\"      Date: 02/15/2012
   6 .\"    Manual: systemd-logind.conf
   7 .\"    Source: systemd
   8 .\"  Language: English
   9 .\"
  10 .TH "SYSTEMD\-LOGIND\&.CO" "5" "02/15/2012" "systemd" "systemd-logind.conf"
  11 .\" -----------------------------------------------------------------
  12 .\" * Define some portability stuff
  13 .\" -----------------------------------------------------------------
  14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15 .\" http://bugs.debian.org/507673
  16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
  17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  18 .ie \n(.g .ds Aq \(aq
  19 .el       .ds Aq '
  20 .\" -----------------------------------------------------------------
  21 .\" * set default formatting
  22 .\" -----------------------------------------------------------------
  23 .\" disable hyphenation
  24 .nh
  25 .\" disable justification (adjust text to left margin only)
  26 .ad l
  27 .\" -----------------------------------------------------------------
  28 .\" * MAIN CONTENT STARTS HERE *
  29 .\" -----------------------------------------------------------------
  30 .SH "NAME"
  31 systemd-logind.conf \- login manager configuration file
  32 .SH "SYNOPSIS"
  33 .PP
  34 systemd\-login\&.conf
  35 .SH "DESCRIPTION"
  36 .PP
  37 This files configures various parameters of the systemd login manager\&.
  38 .SH "OPTIONS"
  39 .PP
  40 All options are configured in the
  41 [Login]
  42 section:
  43 .PP
  44 \fINAutoVTs=\fR
  45 .RS 4
  46 Takes a positive integer\&. How many virtual terminals to allocate by default and when switched to autospawn
  47 autovt
  48 services on (if they are otherwise unused)\&. These services are instantiated from a template of
  49 autovt@\&.service
  50 with the virtual terminal TTY name, e\&.g\&.
  51 autovt@tty4\&.service\&. By default
  52 autovt@\&.service
  53 is linked to
  54 getty@\&.service, i\&.e\&. login prompts are started dynamically as the user switches to unused virtual terminals, and this parameter hence controls how many gettys are available on the virtual terminals\&. Defaults to 6\&. When set to 0, automatic spawning of
  55 autovt
  56 services is disabled\&.
  57 .RE
  58 .PP
  59 \fIKillUserProcesses=\fR
  60 .RS 4
  61 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
  62 no\&.
  63 .RE
  64 .PP
  65 \fIKillOnlyUsers=\fR, \fIKillExcludeUsers=\fR
  66 .RS 4
  67 These settings take space separated lists of user names that influence the effect of
  68 \fIKillUserProcesses=\fR\&. If not empty only processes of users listed in
  69 \fIKillOnlyUsers\fR
  70 will be killed when they log out entirely\&. Processes of users listed in
  71 \fIKillExcludeUsers=\fR
  72 are excluded from being killed\&.
  73 \fIKillExcludeUsers=\fR
  74 defaults to
  75 root
  76 and takes precedence over
  77 \fIKillOnlyUsers=\fR
  78 which defaults to the empty list\&.
  79 .RE
  80 .PP
  81 \fIControllers=\fR, \fIResetControllers=\fR
  82 .RS 4
  83 These settings control the default control group hierarchies users logging are added to\&. When logging in users will get private control groups in all hierarchies listed in
  84 \fIControllers=\fR
  85 and be reset to the root control group in all hierarchies listed in
  86 \fIResetControllers=\fR\&.
  87 \fIControllers=\fR
  88 defaults to the empty list,
  89 \fIResetControllers=\fR
  90 defaults to
  91 cpu\&.
  92 .RE
  93 .PP
  94 Note that setting
  95 \fIKillUserProcesses=1\fR
  96 will break tools like
  97 \fBscreen\fR(1)\&.
  98 .PP
  99 Note that
 100 \fIKillUserProcesses=1\fR
 101 is a weaker version of
 102 \fIkill\-session\-processes=1\fR
 103 which may be configured per\-service for
 104 \fBpam_systemd\fR(8)\&. 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\&.
 105 .SH "SEE ALSO"
 106 .PP
 107
 108 \fBsystemd\fR(1),
 109 \fBsystemd-loginctl\fR(1),
 110 \fBsystemd.conf\fR(5)
 111 .SH "AUTHOR"
 112 .PP
 113 \fBLennart Poettering\fR <\&lennart@poettering\&.net\&>
 114 .RS 4
 115 Developer
 116 .RE