[thirdparty/systemd.git] / man / systemd.conf.xml

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

<!--
  This file is part of systemd.

  Copyright 2010 Lennart Poettering

  systemd is free software; you can redistribute it and/or modify it
  under the terms of the GNU Lesser General Public License as published by
  the Free Software Foundation; either version 2.1 of the License, or
  (at your option) any later version.

  systemd is distributed in the hope that it will be useful, but
  WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  Lesser General Public License for more details.

  You should have received a copy of the GNU Lesser General Public License
  along with systemd; If not, see <http://www.gnu.org/licenses/>.
-->

<refentry id="systemd.conf">
        <refentryinfo>
                <title>systemd.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>systemd.conf</refentrytitle>
                <manvolnum>5</manvolnum>
        </refmeta>

        <refnamediv>
                <refname>systemd.conf</refname>
                <refpurpose>systemd manager configuration file</refpurpose>
        </refnamediv>

        <refsynopsisdiv>
                <para><filename>system.conf</filename></para>
                <para><filename>user.conf</filename></para>
        </refsynopsisdiv>

        <refsect1>
                <title>Description</title>

                <para>When run as system instance systemd reads the
                configuration file <filename>system.conf</filename>,
                otherwise <filename>user.conf</filename>. These
                configuration files contain a few settings controlling
                basic manager operations.</para>

        </refsect1>

        <refsect1>
                <title>Options</title>

                <para>All options are configured in the
                <literal>[Manager]</literal> section:</para>

                <variablelist>

                        <varlistentry>
                                <term><varname>LogLevel=</varname></term>
                                <term><varname>LogTarget=</varname></term>
                                <term><varname>LogColor=</varname></term>
                                <term><varname>LogLocation=</varname></term>
                                <term><varname>DumpCore=yes</varname></term>
                                <term><varname>CrashShell=no</varname></term>
                                <term><varname>ShowStatus=yes</varname></term>
                                <term><varname>SysVConsole=yes</varname></term>
                                <term><varname>CrashChVT=1</varname></term>
                                <term><varname>DefaultStandardOutput=journal</varname></term>
                                <term><varname>DefaultStandardError=inherit</varname></term>

                                <listitem><para>Configures various
                                parameters of basic manager
                                operation. These options may be
                                overridden by the respective command
                                line arguments. See
                                <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>
                                for details about these command line
                                arguments.</para></listitem>
                        </varlistentry>

                        <varlistentry>
                                <term><varname>CPUAffinity=</varname></term>

                                <listitem><para>Configures the initial
                                CPU affinity for the init
                                process. Takes a space-separated list
                                of CPU indexes.</para></listitem>
                        </varlistentry>

                        <varlistentry>
                                <term><varname>MountAuto=yes</varname></term>
                                <term><varname>SwapAuto=yes</varname></term>

                                <listitem><para>Configures whether
                                systemd should automatically activate
                                all swap or mounts listed in
                                <filename>/etc/fstab</filename>, or
                                whether this job is left to some other
                                system script.</para></listitem>
                        </varlistentry>

                        <varlistentry>
                                <term><varname>DefaultControllers=cpu</varname></term>

                                <listitem><para>Configures in which
                                cgroup controller hierarchies to
                                create per-service cgroups
                                automatically, in addition to the
                                name=systemd named hierarchy. Defaults
                                to 'cpu'. Takes a space separated list
                                of controller names. Pass an empty
                                string to ensure that systemd does not
                                touch any hierarchies but its
                                own.</para></listitem>
                        </varlistentry>

                        <varlistentry>
                                <term><varname>JoinControllers=cpu,cpuacct</varname></term>

                                <listitem><para>Configures controllers
                                that shall be mounted in a single
                                hierarchy. By default systemd will
                                mount all controllers which are
                                enabled in the kernel in individual
                                hierachies, with the exception of
                                those listed in this setting. Takes a
                                space separated list of comma
                                separated controller names, in order
                                to allow multiple joined
                                hierarchies. Defaults to
                                'cpu,cpuacct'. Pass an empty string to
                                ensure that systemd mounts all
                                controllers in separate
                                hierarchies.</para></listitem>
                        </varlistentry>

                        <varlistentry>
                                <term><varname>RuntimeWatchdogSec=</varname></term>
                                <term><varname>ShutdownWatchdogSec=</varname></term>

                                <listitem><para>Configure the hardware
                                watchdog at runtime and at
                                reboot. Takes a timeout value in
                                seconds (or in other time units if
                                suffixed with <literal>ms</literal>,
                                <literal>min</literal>,
                                <literal>h</literal>,
                                <literal>d</literal>,
                                <literal>w</literal>). If
                                <varname>RuntimeWatchdogSec=</varname>
                                is set to a non-zero value the
                                watchdog hardware
                                (<filename>/dev/watchdog</filename>)
                                will be programmed to automatically
                                reboot the system if it is not
                                contacted within the specified timeout
                                interval. The system manager will
                                ensure to contact it at least once in
                                half the specified timeout
                                interval. This feature requires a
                                hardware watchdog device to be
                                present, as it is commonly the case in
                                embedded and server systems. Not all
                                hardware watchdogs allow configuration
                                of the reboot timeout, in which case
                                the closest available timeout is
                                picked. <varname>ShutdownWatchdogSec=</varname>
                                may be used to configure the hardware
                                watchdog when the system is asked to
                                reboot. It works as a safety net to
                                ensure that the reboot takes place
                                even if a clean reboot attempt times
                                out. By default
                                <varname>RuntimeWatchdogSec=</varname>
                                defaults to 0 (off), and
                                <varname>ShutdownWatchdogSec=</varname>
                                to 10min. These settings have no
                                effect if a hardware watchdog is not
                                available.</para></listitem>
                        </varlistentry>
                </variablelist>
        </refsect1>

        <refsect1>
                  <title>See Also</title>
                  <para>
                          <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>
                  </para>
        </refsect1>

</refentry>
Commit	Line	Data
f3e219a2 LP	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
5430f7f2 LP	12	under the terms of the GNU Lesser General Public License as published by
5430f7f2 LP	13	the Free Software Foundation; either version 2.1 of the License, or
f3e219a2 LP	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
5430f7f2	19	Lesser General Public License for more details.
f3e219a2	20
5430f7f2	21	You should have received a copy of the GNU Lesser General Public License
f3e219a2 LP	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>
af2d49f7	52	<para><filename>user.conf</filename></para>
f3e219a2 LP	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>,
af2d49f7	60	otherwise <filename>user.conf</filename>. These
f3e219a2 LP	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>
af2d49f7	82	<term><varname>SysVConsole=yes</varname></term>
f3e219a2	83	<term><varname>CrashChVT=1</varname></term>
706343f4	84	<term><varname>DefaultStandardOutput=journal</varname></term>
0a494f1f	85	<term><varname>DefaultStandardError=inherit</varname></term>
f3e219a2 LP	86
	87	<listitem><para>Configures various
	88	parameters of basic manager
	89	operation. These options may be
5471472d	90	overridden by the respective command
f3e219a2 LP	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
96d4ce01	102	process. Takes a space-separated list
f3e219a2 LP	103	of CPU indexes.</para></listitem>
f3e219a2 LP	104	</varlistentry>
af2d49f7 LP	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>
06d4c99a LP	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
5471472d	126	to 'cpu'. Takes a space separated list
06d4c99a LP	127	of controller names. Pass an empty
06d4c99a LP	128	string to ensure that systemd does not
5471472d	129	touch any hierarchies but its
06d4c99a LP	130	own.</para></listitem>
06d4c99a LP	131	</varlistentry>
0c85a4f3 LP	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>
e96d6be7 LP	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>
f3e219a2 LP	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>