1
1
mirror of https://github.com/systemd/systemd-stable.git synced 2024-12-24 21:34:08 +03:00

Table is easier to grasp

State goes in CONFIG for users

3rd review
This commit is contained in:
Bruno Vernay 2018-06-07 17:38:10 +02:00 committed by Zbigniew Jędrzejewski-Szmek
parent 7590ebc5e7
commit 8d00da49fb

View File

@ -805,13 +805,48 @@ CapabilityBoundingSet=~CAP_B CAP_C</programlisting>
<listitem><para>These options take a whitespace-separated list of directory names. The specified directory <listitem><para>These options take a whitespace-separated list of directory names. The specified directory
names must be relative, and may not include <literal>..</literal>. If set, one or more names must be relative, and may not include <literal>..</literal>. If set, one or more
directories by the specified names will be created (including their parents) below <filename>/run</filename> directories by the specified names will be created (including their parents) below the locations
(or <varname>$XDG_RUNTIME_DIR</varname> for user services), <filename>/var/lib</filename> (or defined in the following table, when the unit is started.</para>
<varname>$XDG_CONFIG_HOME</varname> for user services), <filename>/var/cache</filename> (or <table>
<varname>$XDG_CACHE_HOME</varname> for user services), <filename>/var/log</filename> (or <title>Automatic directory creation</title>
<varname>$XDG_CONFIG_HOME</varname><filename>/log</filename> for user services), or <filename>/etc</filename> <tgroup cols='3'>
(or <varname>$XDG_CONFIG_HOME</varname> for user services), respectively, when the unit is started.</para> <thead>
<row>
<entry>Locations</entry>
<entry>for system</entry>
<entry>for users</entry>
</row>
</thead>
<tbody>
<row>
<entry><varname>RuntimeDirectory=</varname></entry>
<entry><filename>/run</filename></entry>
<entry><varname>$XDG_RUNTIME_DIR</varname></entry>
</row>
<row>
<entry><varname>StateDirectory=</varname></entry>
<entry><filename>/var/lib</filename></entry>
<entry><varname>$XDG_CONFIG_HOME</varname></entry>
</row>
<row>
<entry><varname>CacheDirectory=</varname></entry>
<entry><filename>/var/cache</filename></entry>
<entry><varname>$XDG_CACHE_HOME</varname></entry>
</row>
<row>
<entry><varname>LogsDirectory=</varname></entry>
<entry><filename>/var/log</filename></entry>
<entry><varname>$XDG_CONFIG_HOME</varname><filename>/log</filename></entry>
</row>
<row>
<entry><varname>ConfigurationDirectory=</varname></entry>
<entry><filename>/etc</filename></entry>
<entry><varname>$XDG_CONFIG_HOME</varname></entry>
</row>
</tbody>
</tgroup>
</table>
<para>In case of <varname>RuntimeDirectory=</varname> the lowest subdirectories are removed when the unit is <para>In case of <varname>RuntimeDirectory=</varname> the lowest subdirectories are removed when the unit is
stopped. It is possible to preserve the specified directories in this case if stopped. It is possible to preserve the specified directories in this case if
<varname>RuntimeDirectoryPreserve=</varname> is configured to <option>restart</option> or <option>yes</option> <varname>RuntimeDirectoryPreserve=</varname> is configured to <option>restart</option> or <option>yes</option>