chiark / gitweb /
headers: fix git URLs for source files
[elogind.git] / 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
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                 </variablelist>
153         </refsect1>
154
155         <refsect1>
156                   <title>See Also</title>
157                   <para>
158                           <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>
159                   </para>
160         </refsect1>
161
162 </refentry>