diff options
| author | Lennart Poettering <lennart@poettering.net> | 2014-03-03 17:14:07 +0100 |
|---|---|---|
| committer | Lennart Poettering <lennart@poettering.net> | 2014-03-03 17:55:32 +0100 |
| commit | e66cf1a3f94fff48a572f6dbd19b43c9bcf7b8c7 (patch) | |
| tree | e3580f7a1e9aaca01ada8575a1ea50a7a32dd2d3 /man/systemd.exec.xml | |
| parent | b64a3d86bcc3b3698824019d0ebdc2117ad31bb5 (diff) | |
core: introduce new RuntimeDirectory= and RuntimeDirectoryMode= unit settings
As discussed on the ML these are useful to manage runtime directories
below /run for services.
Diffstat (limited to 'man/systemd.exec.xml')
| -rw-r--r-- | man/systemd.exec.xml | 41 |
1 files changed, 41 insertions, 0 deletions
diff --git a/man/systemd.exec.xml b/man/systemd.exec.xml index 9224f1ef3d..f1bcf9b7bd 100644 --- a/man/systemd.exec.xml +++ b/man/systemd.exec.xml @@ -1195,6 +1195,46 @@ kernel.</para></listitem> </varlistentry> + <varlistentry> + <term><varname>RuntimeDirectory=</varname></term> + <term><varname>RuntimeDirectoryMode=</varname></term> + + <listitem><para>Takes a list of + directory names. If set one or more + directories by the specified names + will be created below + <filename>/run</filename> (for system + services) or below + <varname>$XDG_RUNTIME_DIR</varname> + (for user services) when the unit is + started and removed when the unit is + stopped. The directories will have the + access mode specified in + <varname>RuntimeDirectoryMode=</varname>, + and will be owned by the user and + group specified in + <varname>User=</varname> and + <varname>Group=</varname>. Use this to + manage one or more runtime directories + of the unit and bind their lifetime to + the daemon runtime. The specified + directory names must be relative, and + may not include a + <literal>/</literal>, i.e. must refer + to simple directories to create or + remove. This is particularly useful + for unpriviliges daemons that cannot + create runtime directories in + <filename>/run</filename> due to lack + of privileges, and to make sure the + runtime directory is cleaned up + automatically after use. For runtime + directories that require more complex + or different configuration or lifetime + guarantees, please consider using + <citerefentry><refentrytitle>tmpfiles.d</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para></listitem> + </varlistentry> + </variablelist> </refsect1> @@ -1352,6 +1392,7 @@ <citerefentry><refentrytitle>systemd.kill</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>systemd.resource-control</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>systemd.directives</refentrytitle><manvolnum>7</manvolnum></citerefentry>, + <citerefentry><refentrytitle>tmpfiles.d</refentrytitle><manvolnum>5</manvolnum></citerefentry>, <citerefentry><refentrytitle>exec</refentrytitle><manvolnum>3</manvolnum></citerefentry> </para> </refsect1> |