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 General Public License as published by
  13   the Free Software Foundation; either version 2 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   General Public License for more details.
  20
  21   You should have received a copy of the GNU 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=null</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                 </variablelist>
 133         </refsect1>
 134
 135         <refsect1>
 136                   <title>See Also</title>
 137                   <para>
 138                           <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>
 139                   </para>
 140         </refsect1>
 141
 142 </refentry>