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

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