]>
Commit | Line | Data |
---|---|---|
f47781d8 MP |
1 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>systemd-system.conf</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><style> |
2 | a.headerlink { | |
3 | color: #c60f0f; | |
4 | font-size: 0.8em; | |
5 | padding: 0 4px 0 4px; | |
6 | text-decoration: none; | |
7 | visibility: hidden; | |
8 | } | |
9 | ||
10 | a.headerlink:hover { | |
11 | background-color: #c60f0f; | |
12 | color: white; | |
13 | } | |
14 | ||
15 | h1:hover > a.headerlink, h2:hover > a.headerlink, h3:hover > a.headerlink, dt:hover > a.headerlink { | |
16 | visibility: visible; | |
17 | } | |
18 | </style><a href="index.html">Index </a>· | |
19 | <a href="systemd.directives.html">Directives </a>· | |
20 | <a href="../python-systemd/index.html">Python </a>· | |
21 | <a href="../libudev/index.html">libudev </a>· | |
e735f4d4 MP |
22 | <a href="../libudev/index.html">gudev </a><span style="float:right">systemd 219</span><hr><div class="refentry"><a name="systemd-system.conf"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>systemd-system.conf, system.conf.d, systemd-user.conf, user.conf.d — System and session service manager configuration files</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p><code class="filename">/etc/systemd/system.conf</code></p><p><code class="filename">/etc/systemd/system.conf.d/*.conf</code></p><p><code class="filename">/run/systemd/system.conf.d/*.conf</code></p><p><code class="filename">/usr/lib/systemd/system.conf.d/*.conf</code></p><p><code class="filename">/etc/systemd/user.conf</code></p><p><code class="filename">/etc/systemd/user.conf.d/*.conf</code></p><p><code class="filename">/run/systemd/user.conf.d/*.conf</code></p><p><code class="filename">/usr/lib/systemd/user.conf.d/*.conf</code></p></div><div class="refsect1"><a name="idm140311371378672"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p>When run as a system instance, systemd interprets the |
23 | configuration file <code class="filename">system.conf</code> and the files | |
24 | in <code class="filename">system.conf.d</code> directories; when run as a | |
25 | user instance, systemd interprets the configuration file | |
26 | <code class="filename">user.conf</code> and the files in | |
27 | <code class="filename">user.conf.d</code> directories. These configuration | |
28 | files contain a few settings controlling basic manager | |
29 | operations.</p></div><div class="refsection"><a name="confd"></a><h2>Configuration Directories and Precedence</h2><p>Configuration files are read from directories in | |
f47781d8 MP |
30 | <code class="filename">/etc/</code>, <code class="filename">/run/</code>, and |
31 | <code class="filename">/usr/lib/</code>, in order of precedence. | |
32 | Each configuration file in these configuration directories shall be named in | |
33 | the style of <code class="filename"><em class="replaceable"><code>filename</code></em>.conf</code>. | |
34 | Files in <code class="filename">/etc/</code> override files with the same name in | |
35 | <code class="filename">/run/</code> and <code class="filename">/usr/lib/</code>. Files in | |
36 | <code class="filename">/run/</code> override files with the same name in | |
37 | <code class="filename">/usr/lib/</code>.</p><p>Packages should install their configuration files in | |
38 | <code class="filename">/usr/lib/</code>. Files in <code class="filename">/etc/</code> are | |
39 | reserved for the local administrator, who may use this logic to override the | |
40 | configuration files installed by vendor packages. All configuration files | |
41 | are sorted by their filename in lexicographic order, regardless of which of | |
42 | the directories they reside in. If multiple files specify the same option, | |
43 | the entry in the file with the lexicographically latest name will take | |
44 | precedence. It is recommended to prefix all filenames with a two-digit number | |
45 | and a dash, to simplify the ordering of the files.</p><p>If the administrator wants to disable a configuration file supplied by | |
46 | the vendor, the recommended way is to place a symlink to | |
47 | <code class="filename">/dev/null</code> in the configuration directory in | |
48 | <code class="filename">/etc/</code>, with the same filename as the vendor | |
49 | configuration file.</p></div><div class="refsection"><a name="conf"></a><h2>Configuration File</h2><p>Configuration is also read from a single configuration file in | |
50 | <code class="filename">/etc/</code>. This file is read before any of the | |
51 | configuration directories, and has the lowest precedence; entries in a file | |
52 | in any configuration directory override entries in the single configuration | |
e735f4d4 MP |
53 | file.</p></div><div class="refsect1"><a name="idm140311371372688"></a><h2 id="Options">Options<a class="headerlink" title="Permalink to this headline" href="#Options">¶</a></h2><p>All options are configured in the |
54 | "<code class="literal">[Manager]</code>" section:</p><div class="variablelist"><dl class="variablelist"><dt id="LogLevel="><span class="term"><code class="varname">LogLevel=</code>, </span><span class="term"><code class="varname">LogTarget=</code>, </span><span class="term"><code class="varname">LogColor=</code>, </span><span class="term"><code class="varname">LogLocation=</code>, </span><span class="term"><code class="varname">DumpCore=yes</code>, </span><span class="term"><code class="varname">CrashShell=no</code>, </span><span class="term"><code class="varname">ShowStatus=yes</code>, </span><span class="term"><code class="varname">CrashChVT=1</code>, </span><span class="term"><code class="varname">DefaultStandardOutput=journal</code>, </span><span class="term"><code class="varname">DefaultStandardError=inherit</code></span><a class="headerlink" title="Permalink to this term" href="#LogLevel=">¶</a></dt><dd><p>Configures various parameters of basic manager | |
55 | operation. These options may be overridden by the respective | |
56 | command line arguments. See | |
57 | <a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a> | |
58 | for details about these command line | |
59 | arguments.</p></dd><dt id="CPUAffinity="><span class="term"><code class="varname">CPUAffinity=</code></span><a class="headerlink" title="Permalink to this term" href="#CPUAffinity=">¶</a></dt><dd><p>Configures the initial CPU affinity for the | |
60 | init process. Takes a space-separated list of CPU | |
61 | indices.</p></dd><dt id="JoinControllers=cpu,cpuacct net_cls,netprio"><span class="term"><code class="varname">JoinControllers=cpu,cpuacct net_cls,netprio</code></span><a class="headerlink" title="Permalink to this term" href="#JoinControllers=cpu,cpuacct%20net_cls,netprio">¶</a></dt><dd><p>Configures controllers that shall be mounted | |
62 | in a single hierarchy. By default, systemd will mount all | |
63 | controllers which are enabled in the kernel in individual | |
64 | hierarchies, with the exception of those listed in this | |
65 | setting. Takes a space-separated list of comma-separated | |
66 | controller names, in order to allow multiple joined | |
67 | hierarchies. Defaults to 'cpu,cpuacct'. Pass an empty string | |
68 | to ensure that systemd mounts all controllers in separate | |
69 | hierarchies.</p><p>Note that this option is only applied once, at very | |
70 | early boot. If you use an initial RAM disk (initrd) that uses | |
71 | systemd, it might hence be necessary to rebuild the initrd if | |
72 | this option is changed, and make sure the new configuration | |
73 | file is included in it. Otherwise, the initrd might mount the | |
74 | controller hierarchies in a different configuration than | |
75 | intended, and the main system cannot remount them | |
76 | anymore.</p></dd><dt id="RuntimeWatchdogSec="><span class="term"><code class="varname">RuntimeWatchdogSec=</code>, </span><span class="term"><code class="varname">ShutdownWatchdogSec=</code></span><a class="headerlink" title="Permalink to this term" href="#RuntimeWatchdogSec=">¶</a></dt><dd><p>Configure the hardware watchdog at runtime and | |
77 | at reboot. Takes a timeout value in seconds (or in other time | |
78 | units if suffixed with "<code class="literal">ms</code>", | |
79 | "<code class="literal">min</code>", "<code class="literal">h</code>", | |
80 | "<code class="literal">d</code>", "<code class="literal">w</code>"). If | |
81 | <code class="varname">RuntimeWatchdogSec=</code> is set to a non-zero | |
82 | value, the watchdog hardware | |
83 | (<code class="filename">/dev/watchdog</code>) will be programmed to | |
84 | automatically reboot the system if it is not contacted within | |
85 | the specified timeout interval. The system manager will ensure | |
86 | to contact it at least once in half the specified timeout | |
87 | interval. This feature requires a hardware watchdog device to | |
88 | be present, as it is commonly the case in embedded and server | |
89 | systems. Not all hardware watchdogs allow configuration of the | |
90 | reboot timeout, in which case the closest available timeout is | |
91 | picked. <code class="varname">ShutdownWatchdogSec=</code> may be used to | |
92 | configure the hardware watchdog when the system is asked to | |
93 | reboot. It works as a safety net to ensure that the reboot | |
94 | takes place even if a clean reboot attempt times out. By | |
95 | default <code class="varname">RuntimeWatchdogSec=</code> defaults to 0 | |
96 | (off), and <code class="varname">ShutdownWatchdogSec=</code> to 10min. | |
97 | These settings have no effect if a hardware watchdog is not | |
98 | available.</p></dd><dt id="CapabilityBoundingSet="><span class="term"><code class="varname">CapabilityBoundingSet=</code></span><a class="headerlink" title="Permalink to this term" href="#CapabilityBoundingSet=">¶</a></dt><dd><p>Controls which capabilities to include in the | |
99 | capability bounding set for PID 1 and its children. See | |
100 | <a href="http://man7.org/linux/man-pages/man7/capabilities.7.html"><span class="citerefentry"><span class="refentrytitle">capabilities</span>(7)</span></a> | |
101 | for details. Takes a whitespace-separated list of capability | |
102 | names as read by | |
103 | <a href="cap_from_name.html"><span class="citerefentry"><span class="refentrytitle">cap_from_name</span>(3)</span></a>. | |
104 | Capabilities listed will be included in the bounding set, all | |
105 | others are removed. If the list of capabilities is prefixed | |
106 | with ~, all but the listed capabilities will be included, the | |
107 | effect of the assignment inverted. Note that this option also | |
108 | affects the respective capabilities in the effective, | |
109 | permitted and inheritable capability sets. The capability | |
110 | bounding set may also be individually configured for units | |
111 | using the <code class="varname">CapabilityBoundingSet=</code> directive | |
112 | for units, but note that capabilities dropped for PID 1 cannot | |
113 | be regained in individual units, they are lost for | |
114 | good.</p></dd><dt id="SystemCallArchitectures="><span class="term"><code class="varname">SystemCallArchitectures=</code></span><a class="headerlink" title="Permalink to this term" href="#SystemCallArchitectures=">¶</a></dt><dd><p>Takes a space-separated list of architecture | |
115 | identifiers. Selects from which architectures system calls may | |
116 | be invoked on this system. This may be used as an effective | |
117 | way to disable invocation of non-native binaries system-wide, | |
118 | for example to prohibit execution of 32-bit x86 binaries on | |
119 | 64-bit x86-64 systems. This option operates system-wide, and | |
120 | acts similar to the | |
121 | <code class="varname">SystemCallArchitectures=</code> setting of unit | |
122 | files, see | |
123 | <a href="systemd.exec.html"><span class="citerefentry"><span class="refentrytitle">systemd.exec</span>(5)</span></a> | |
124 | for details. This setting defaults to the empty list, in which | |
125 | case no filtering of system calls based on architecture is | |
126 | applied. Known architecture identifiers are | |
127 | "<code class="literal">x86</code>", "<code class="literal">x86-64</code>", | |
128 | "<code class="literal">x32</code>", "<code class="literal">arm</code>" and the special | |
129 | identifier "<code class="literal">native</code>". The latter implicitly | |
130 | maps to the native architecture of the system (or more | |
131 | specifically, the architecture the system manager was compiled | |
132 | for). Set this setting to "<code class="literal">native</code>" to | |
133 | prohibit execution of any non-native binaries. When a binary | |
134 | executes a system call of an architecture that is not listed | |
135 | in this setting, it will be immediately terminated with the | |
136 | SIGSYS signal.</p></dd><dt id="TimerSlackNSec="><span class="term"><code class="varname">TimerSlackNSec=</code></span><a class="headerlink" title="Permalink to this term" href="#TimerSlackNSec=">¶</a></dt><dd><p>Sets the timer slack in nanoseconds for PID 1, | |
137 | which is inherited by all executed processes, unless | |
138 | overridden individually, for example with the | |
139 | <code class="varname">TimerSlackNSec=</code> setting in service units | |
140 | (for details see | |
141 | <a href="systemd.exec.html"><span class="citerefentry"><span class="refentrytitle">systemd.exec</span>(5)</span></a>). | |
142 | The timer slack controls the accuracy of wake-ups triggered by | |
143 | system timers. See | |
144 | <a href="http://man7.org/linux/man-pages/man2/prctl.2.html"><span class="citerefentry"><span class="refentrytitle">prctl</span>(2)</span></a> | |
145 | for more information. Note that in contrast to most other time | |
146 | span definitions this parameter takes an integer value in | |
147 | nano-seconds if no unit is specified. The usual time units are | |
148 | understood too.</p></dd><dt id="DefaultTimerAccuracySec="><span class="term"><code class="varname">DefaultTimerAccuracySec=</code></span><a class="headerlink" title="Permalink to this term" href="#DefaultTimerAccuracySec=">¶</a></dt><dd><p>Sets the default accuracy of timer units. This | |
149 | controls the global default for the | |
150 | <code class="varname">AccuracySec=</code> setting of timer units, see | |
151 | <a href="systemd.timer.html"><span class="citerefentry"><span class="refentrytitle">systemd.timer</span>(5)</span></a> | |
152 | for details. <code class="varname">AccuracySec=</code> set in individual | |
153 | units override the global default for the specific unit. | |
154 | Defaults to 1min. Note that the accuracy of timer units is | |
155 | also affected by the configured timer slack for PID 1, see | |
156 | <code class="varname">TimerSlackNSec=</code> above.</p></dd><dt id="DefaultTimeoutStartSec="><span class="term"><code class="varname">DefaultTimeoutStartSec=</code>, </span><span class="term"><code class="varname">DefaultTimeoutStopSec=</code>, </span><span class="term"><code class="varname">DefaultRestartSec=</code></span><a class="headerlink" title="Permalink to this term" href="#DefaultTimeoutStartSec=">¶</a></dt><dd><p>Configures the default timeouts for starting | |
157 | and stopping of units, as well as the default time to sleep | |
158 | between automatic restarts of units, as configured per-unit in | |
159 | <code class="varname">TimeoutStartSec=</code>, | |
160 | <code class="varname">TimeoutStopSec=</code> and | |
161 | <code class="varname">RestartSec=</code> (for services, see | |
162 | <a href="systemd.service.html"><span class="citerefentry"><span class="refentrytitle">systemd.service</span>(5)</span></a> | |
163 | for details on the per-unit settings). For non-service units, | |
164 | <code class="varname">DefaultTimeoutStartSec=</code> sets the default | |
165 | <code class="varname">TimeoutSec=</code> value. </p></dd><dt id="DefaultStartLimitInterval="><span class="term"><code class="varname">DefaultStartLimitInterval=</code>, </span><span class="term"><code class="varname">DefaultStartLimitBurst=</code></span><a class="headerlink" title="Permalink to this term" href="#DefaultStartLimitInterval=">¶</a></dt><dd><p>Configure the default unit start rate | |
166 | limiting, as configured per-service by | |
167 | <code class="varname">StartLimitInterval=</code> and | |
168 | <code class="varname">StartLimitBurst=</code>. See | |
169 | <a href="systemd.service.html"><span class="citerefentry"><span class="refentrytitle">systemd.service</span>(5)</span></a> | |
170 | for details on the per-service settings.</p></dd><dt id="DefaultEnvironment="><span class="term"><code class="varname">DefaultEnvironment=</code></span><a class="headerlink" title="Permalink to this term" href="#DefaultEnvironment=">¶</a></dt><dd><p>Sets manager environment variables passed to | |
171 | all executed processes. Takes a space-separated list of | |
172 | variable assignments. See | |
173 | <a href="http://man7.org/linux/man-pages/man7/environ.7.html"><span class="citerefentry"><span class="refentrytitle">environ</span>(7)</span></a> | |
174 | for details about environment variables.</p><p>Example: | |
f47781d8 | 175 | |
e735f4d4 | 176 | </p><pre class="programlisting">DefaultEnvironment="VAR1=word1 word2" VAR2=word3 "VAR3=word 5 6"</pre><p> |
f47781d8 | 177 | |
e735f4d4 MP |
178 | Sets three variables |
179 | "<code class="literal">VAR1</code>", | |
180 | "<code class="literal">VAR2</code>", | |
181 | "<code class="literal">VAR3</code>".</p></dd><dt id="DefaultCPUAccounting="><span class="term"><code class="varname">DefaultCPUAccounting=</code>, </span><span class="term"><code class="varname">DefaultBlockIOAccounting=</code>, </span><span class="term"><code class="varname">DefaultMemoryAccounting=</code></span><a class="headerlink" title="Permalink to this term" href="#DefaultCPUAccounting=">¶</a></dt><dd><p>Configure the default resource accounting | |
182 | settings, as configured per-unit by | |
183 | <code class="varname">CPUAccounting=</code>, | |
184 | <code class="varname">BlockIOAccounting=</code> and | |
185 | <code class="varname">MemoryAccounting=</code>. See | |
186 | <a href="systemd.resource-control.html"><span class="citerefentry"><span class="refentrytitle">systemd.resource-control</span>(5)</span></a> | |
187 | for details on the per-unit settings.</p></dd><dt id="DefaultLimitCPU="><span class="term"><code class="varname">DefaultLimitCPU=</code>, </span><span class="term"><code class="varname">DefaultLimitFSIZE=</code>, </span><span class="term"><code class="varname">DefaultLimitDATA=</code>, </span><span class="term"><code class="varname">DefaultLimitSTACK=</code>, </span><span class="term"><code class="varname">DefaultLimitCORE=</code>, </span><span class="term"><code class="varname">DefaultLimitRSS=</code>, </span><span class="term"><code class="varname">DefaultLimitNOFILE=</code>, </span><span class="term"><code class="varname">DefaultLimitAS=</code>, </span><span class="term"><code class="varname">DefaultLimitNPROC=</code>, </span><span class="term"><code class="varname">DefaultLimitMEMLOCK=</code>, </span><span class="term"><code class="varname">DefaultLimitLOCKS=</code>, </span><span class="term"><code class="varname">DefaultLimitSIGPENDING=</code>, </span><span class="term"><code class="varname">DefaultLimitMSGQUEUE=</code>, </span><span class="term"><code class="varname">DefaultLimitNICE=</code>, </span><span class="term"><code class="varname">DefaultLimitRTPRIO=</code>, </span><span class="term"><code class="varname">DefaultLimitRTTIME=</code></span><a class="headerlink" title="Permalink to this term" href="#DefaultLimitCPU=">¶</a></dt><dd><p>These settings control various default | |
188 | resource limits for units. See | |
189 | <a href="http://man7.org/linux/man-pages/man2/setrlimit.2.html"><span class="citerefentry"><span class="refentrytitle">setrlimit</span>(2)</span></a> | |
190 | for details. Use the string <code class="varname">infinity</code> to | |
191 | configure no limit on a specific resource. These settings may | |
192 | be overridden in individual units using the corresponding | |
193 | LimitXXX= directives. Note that these resource limits are only | |
194 | defaults for units, they are not applied to PID 1 | |
195 | itself.</p></dd></dl></div></div><div class="refsect1"><a name="idm140311370277552"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p> | |
196 | <a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>, | |
197 | <a href="systemd.directives.html"><span class="citerefentry"><span class="refentrytitle">systemd.directives</span>(7)</span></a>, | |
198 | <a href="systemd.exec.html"><span class="citerefentry"><span class="refentrytitle">systemd.exec</span>(5)</span></a>, | |
199 | <a href="systemd.service.html"><span class="citerefentry"><span class="refentrytitle">systemd.service</span>(5)</span></a>, | |
200 | <a href="http://man7.org/linux/man-pages/man7/environ.7.html"><span class="citerefentry"><span class="refentrytitle">environ</span>(7)</span></a>, | |
201 | <a href="http://man7.org/linux/man-pages/man7/capabilities.7.html"><span class="citerefentry"><span class="refentrytitle">capabilities</span>(7)</span></a> | |
202 | </p></div></div></body></html> |