systemd.conf.xml revision e96d6be763014be75d480fde503d0b77f41194a0
220a21d38f675eb835f5758e3d23e896573aa5eaLennart Poettering<?xml-stylesheet type="text/xsl" href="http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl"?>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering This file is part of systemd.
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering Copyright 2010 Lennart Poettering
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering systemd is free software; you can redistribute it and/or modify it
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering under the terms of the GNU General Public License as published by
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering the Free Software Foundation; either version 2 of the License, or
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering (at your option) any later version.
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering systemd is distributed in the hope that it will be useful, but
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering WITHOUT ANY WARRANTY; without even the implied warranty of
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering General Public License for more details.
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering You should have received a copy of the GNU General Public License
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering along with systemd; If not, see <http://www.gnu.org/licenses/>.
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering <refentryinfo>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering </authorgroup>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering </refentryinfo>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering <refentrytitle>systemd.conf</refentrytitle>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering <refpurpose>systemd manager configuration file</refpurpose>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering <refsynopsisdiv>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering <para><filename>system.conf</filename></para>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering <para><filename>user.conf</filename></para>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering </refsynopsisdiv>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering <para>When run as system instance systemd reads the
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering configuration file <filename>system.conf</filename>,
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering otherwise <filename>user.conf</filename>. These
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering configuration files contain a few settings controlling
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering basic manager operations.</para>
a98d5d64720bdf32e3b5f72f896b583e23f730adLennart Poettering <para>All options are configured in the
a98d5d64720bdf32e3b5f72f896b583e23f730adLennart Poettering <literal>[Manager]</literal> section:</para>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering <variablelist>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering <varlistentry>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering <term><varname>LogLevel=</varname></term>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering <term><varname>LogTarget=</varname></term>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering <term><varname>LogColor=</varname></term>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering <term><varname>LogLocation=</varname></term>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering <term><varname>DumpCore=yes</varname></term>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering <term><varname>CrashShell=no</varname></term>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering <term><varname>ShowStatus=yes</varname></term>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering <term><varname>SysVConsole=yes</varname></term>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering <term><varname>CrashChVT=1</varname></term>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering <term><varname>DefaultStandardOutput=journal</varname></term>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering <term><varname>DefaultStandardError=inherit</varname></term>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering parameters of basic manager
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering operation. These options may be
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering overridden by the respective command
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering line arguments. See
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering for details about these command line
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering </varlistentry>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering <varlistentry>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering <term><varname>CPUAffinity=</varname></term>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering CPU affinity for the init
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering process. Takes a space-separated list
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering </varlistentry>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering <varlistentry>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering <term><varname>MountAuto=yes</varname></term>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering <term><varname>SwapAuto=yes</varname></term>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering systemd should automatically activate
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering all swap or mounts listed in
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering whether this job is left to some other
aad803af990f7c88e94427b9278d88afe3a12d38Lennart Poettering </varlistentry>
aad803af990f7c88e94427b9278d88afe3a12d38Lennart Poettering <varlistentry>
aad803af990f7c88e94427b9278d88afe3a12d38Lennart Poettering <term><varname>DefaultControllers=cpu</varname></term>
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering cgroup controller hierarchies to
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering create per-service cgroups
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering automatically, in addition to the
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering name=systemd named hierarchy. Defaults
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering to 'cpu'. Takes a space separated list
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering of controller names. Pass an empty
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering string to ensure that systemd does not
0c11f949db8d6d9899e0c473bf1f8cca0614493eLennart Poettering touch any hierarchies but its
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering </varlistentry>
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering <varlistentry>
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering <term><varname>JoinControllers=cpu,cpuacct</varname></term>
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering that shall be mounted in a single
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering hierarchy. By default systemd will
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering mount all controllers which are
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering enabled in the kernel in individual
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering hierachies, with the exception of
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering those listed in this setting. Takes a
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering space separated list of comma
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering separated controller names, in order
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering to allow multiple joined
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering hierarchies. Defaults to
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering 'cpu,cpuacct'. Pass an empty string to
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering ensure that systemd mounts all
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering controllers in separate
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering </varlistentry>
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering <varlistentry>
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering <term><varname>RuntimeWatchdogSec=</varname></term>
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering <term><varname>ShutdownWatchdogSec=</varname></term>
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering watchdog at runtime and at
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering reboot. Takes a timeout value in
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering seconds (or in other time units if
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering is set to a non-zero value the
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering watchdog hardware
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering will be programmed to automatically
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering reboot the system if it is not
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering contacted within the specified timeout
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering interval. The system manager will
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering ensure to contact it at least once in
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering half the specified timeout
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering interval. This feature requires a
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering hardware watchdog device to be
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering present, as it is commonly the case in
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering embedded and server systems. Not all
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering hardware watchdogs allow configuration
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering of the reboot timeout, in which case
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering the closest available timeout is
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering picked. <varname>ShutdownWatchdogSec=</varname>
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering may be used to configure the hardware
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering watchdog when the system is asked to
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering reboot. It works as a safety net to
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering ensure that the reboot takes place
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering even if a clean reboot attempt times
38a60d7112d33ffd596b23e8df53d75a7c09e71bLennart Poettering out. By default
c269cec334f940d82146f70d69125b1caef08baaLennart Poettering defaults to 0 (off), and
c269cec334f940d82146f70d69125b1caef08baaLennart Poettering to 10min. These settings have no
c269cec334f940d82146f70d69125b1caef08baaLennart Poettering effect if a hardware watchdog is not
c269cec334f940d82146f70d69125b1caef08baaLennart Poettering </varlistentry>
c269cec334f940d82146f70d69125b1caef08baaLennart Poettering </variablelist>
c269cec334f940d82146f70d69125b1caef08baaLennart Poettering <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>