diff options
author | Bruno Vernay <brunovern.a@gmail.com> | 2018-06-07 17:38:10 +0200 |
---|---|---|
committer | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2018-06-11 13:52:55 +0200 |
commit | 8d00da49fbb4f8b1ac2c7ccb0405e0011c2ce5c8 (patch) | |
tree | 62092d956ef03d7c0be5f61b297c5596707320ed /man | |
parent | 7590ebc5e7390baa7eac58fc7338071af1f3a0b4 (diff) | |
download | systemd-8d00da49fbb4f8b1ac2c7ccb0405e0011c2ce5c8.tar.gz |
Table is easier to grasp
State goes in CONFIG for users
3rd review
Diffstat (limited to 'man')
-rw-r--r-- | man/systemd.exec.xml | 49 |
1 files changed, 42 insertions, 7 deletions
diff --git a/man/systemd.exec.xml b/man/systemd.exec.xml index a613c39087..872d51d4ec 100644 --- a/man/systemd.exec.xml +++ b/man/systemd.exec.xml @@ -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 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> - (or <varname>$XDG_RUNTIME_DIR</varname> for user services), <filename>/var/lib</filename> (or - <varname>$XDG_CONFIG_HOME</varname> for user services), <filename>/var/cache</filename> (or - <varname>$XDG_CACHE_HOME</varname> for user services), <filename>/var/log</filename> (or - <varname>$XDG_CONFIG_HOME</varname><filename>/log</filename> for user services), or <filename>/etc</filename> - (or <varname>$XDG_CONFIG_HOME</varname> for user services), respectively, when the unit is started.</para> - + directories by the specified names will be created (including their parents) below the locations + defined in the following table, when the unit is started.</para> + <table> + <title>Automatic directory creation</title> + <tgroup cols='3'> + <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 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> |