man/systemd.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="systemd.conf">
  26         <refentryinfo>
  27                 <title>systemd.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>systemd.conf</refentrytitle>
  42                 <manvolnum>5</manvolnum>
  43         </refmeta>
  44
  45         <refnamediv>
  46                 <refname>systemd.conf</refname>
  47                 <refpurpose>systemd manager configuration file</refpurpose>
  48         </refnamediv>
  49
  50         <refsynopsisdiv>
  51                 <para><filename>system.conf</filename></para>
  52                 <para><filename>user.conf</filename></para>
  53         </refsynopsisdiv>
  54
  55         <refsect1>
  56                 <title>Description</title>
  57
  58                 <para>When run as system instance systemd reads the
  59                 configuration file <filename>system.conf</filename>,
  60                 otherwise <filename>user.conf</filename>. These
  61                 configuration files contain a few settings controlling
  62                 basic manager operations.</para>
  63
  64         </refsect1>
  65
  66         <refsect1>
  67                 <title>Options</title>
  68
  69                 <para>All options are configured in the
  70                 <literal>[Manager]</literal> section:</para>
  71
  72                 <variablelist>
  73
  74                         <varlistentry>
  75                                 <term><varname>LogLevel=</varname></term>
  76                                 <term><varname>LogTarget=</varname></term>
  77                                 <term><varname>LogColor=</varname></term>
  78                                 <term><varname>LogLocation=</varname></term>
  79                                 <term><varname>DumpCore=yes</varname></term>
  80                                 <term><varname>CrashShell=no</varname></term>
  81                                 <term><varname>ShowStatus=yes</varname></term>
  82                                 <term><varname>SysVConsole=yes</varname></term>
  83                                 <term><varname>CrashChVT=1</varname></term>
  84                                 <term><varname>DefaultStandardOutput=journal</varname></term>
  85                                 <term><varname>DefaultStandardError=inherit</varname></term>
  86
  87                                 <listitem><para>Configures various
  88                                 parameters of basic manager
  89                                 operation. These options may be
  90                                 overridden by the respective command
  91                                 line arguments. See
  92                                 <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>
  93                                 for details about these command line
  94                                 arguments.</para></listitem>
  95                         </varlistentry>
  96
  97                         <varlistentry>
  98                                 <term><varname>CPUAffinity=</varname></term>
  99
 100                                 <listitem><para>Configures the initial
 101                                 CPU affinity for the init
 102                                 process. Takes a space-separated list
 103                                 of CPU indexes.</para></listitem>
 104                         </varlistentry>
 105
 106                         <varlistentry>
 107                                 <term><varname>MountAuto=yes</varname></term>
 108                                 <term><varname>SwapAuto=yes</varname></term>
 109
 110                                 <listitem><para>Configures whether
 111                                 systemd should automatically activate
 112                                 all swap or mounts listed in
 113                                 <filename>/etc/fstab</filename>, or
 114                                 whether this job is left to some other
 115                                 system script.</para></listitem>
 116                         </varlistentry>
 117
 118                         <varlistentry>
 119                                 <term><varname>DefaultControllers=cpu</varname></term>
 120
 121                                 <listitem><para>Configures in which
 122                                 cgroup controller hierarchies to
 123                                 create per-service cgroups
 124                                 automatically, in addition to the
 125                                 name=systemd named hierarchy. Defaults
 126                                 to 'cpu'. Takes a space separated list
 127                                 of controller names. Pass an empty
 128                                 string to ensure that systemd does not
 129                                 touch any hierarchies but its
 130                                 own.</para></listitem>
 131                         </varlistentry>
 132
 133                         <varlistentry>
 134                                 <term><varname>JoinControllers=cpu,cpuacct</varname></term>
 135
 136                                 <listitem><para>Configures controllers
 137                                 that shall be mounted in a single
 138                                 hierarchy. By default systemd will
 139                                 mount all controllers which are
 140                                 enabled in the kernel in individual
 141                                 hierachies, with the exception of
 142                                 those listed in this setting. Takes a
 143                                 space separated list of comma
 144                                 separated controller names, in order
 145                                 to allow multiple joined
 146                                 hierarchies. Defaults to
 147                                 'cpu,cpuacct'. Pass an empty string to
 148                                 ensure that systemd mounts all
 149                                 controllers in separate
 150                                 hierarchies.</para></listitem>
 151                         </varlistentry>
 152
 153                         <varlistentry>
 154                                 <term><varname>RuntimeWatchdogSec=</varname></term>
 155                                 <term><varname>ShutdownWatchdogSec=</varname></term>
 156
 157                                 <listitem><para>Configure the hardware
 158                                 watchdog at runtime and at
 159                                 reboot. Takes a timeout value in
 160                                 seconds (or in other time units if
 161                                 suffixed with <literal>ms</literal>,
 162                                 <literal>min</literal>,
 163                                 <literal>h</literal>,
 164                                 <literal>d</literal>,
 165                                 <literal>w</literal>). If
 166                                 <varname>RuntimeWatchdogSec=</varname>
 167                                 is set to a non-zero value the
 168                                 watchdog hardware
 169                                 (<filename>/dev/watchdog</filename>)
 170                                 will be programmed to automatically
 171                                 reboot the system if it is not
 172                                 contacted within the specified timeout
 173                                 interval. The system manager will
 174                                 ensure to contact it at least once in
 175                                 half the specified timeout
 176                                 interval. This feature requires a
 177                                 hardware watchdog device to be
 178                                 present, as it is commonly the case in
 179                                 embedded and server systems. Not all
 180                                 hardware watchdogs allow configuration
 181                                 of the reboot timeout, in which case
 182                                 the closest available timeout is
 183                                 picked. <varname>ShutdownWatchdogSec=</varname>
 184                                 may be used to configure the hardware
 185                                 watchdog when the system is asked to
 186                                 reboot. It works as a safety net to
 187                                 ensure that the reboot takes place
 188                                 even if a clean reboot attempt times
 189                                 out. By default
 190                                 <varname>RuntimeWatchdogSec=</varname>
 191                                 defaults to 0 (off), and
 192                                 <varname>ShutdownWatchdogSec=</varname>
 193                                 to 10min. These settings have no
 194                                 effect if a hardware watchdog is not
 195                                 available.</para></listitem>
 196                         </varlistentry>
 197                 </variablelist>
 198         </refsect1>
 199
 200         <refsect1>
 201                   <title>See Also</title>
 202                   <para>
 203                           <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>
 204                   </para>
 205         </refsect1>
 206
 207 </refentry>