diff options
author | Philip Withnall <withnall@endlessm.com> | 2019-07-03 14:00:48 +0100 |
---|---|---|
committer | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2019-07-04 18:26:03 +0200 |
commit | a9a50bd68089cda36dadf8695565b135c9e21143 (patch) | |
tree | 83e86b254574b1a5c161c54776462f84071b2cf8 | |
parent | 52d8bcd131e7f3c9b7629412302e1ea46ddb70ca (diff) | |
download | systemd-a9a50bd68089cda36dadf8695565b135c9e21143.tar.gz |
man: Add some notes about variable $prefix for StateDirectory=
tl;dr: It isn’t supported.
Wording by Zbigniew Jędrzejewski-Szmek.
See https://twitter.com/pid_eins/status/1102639279614906369 and
https://gitlab.freedesktop.org/libfprint/fprintd/merge_requests/5#note_125536
onwards.
Signed-off-by: Philip Withnall <withnall@endlessm.com>
-rw-r--r-- | man/systemd.exec.xml | 9 |
1 files changed, 9 insertions, 0 deletions
diff --git a/man/systemd.exec.xml b/man/systemd.exec.xml index bacd539b15..56a029a82e 100644 --- a/man/systemd.exec.xml +++ b/man/systemd.exec.xml @@ -972,6 +972,15 @@ CapabilityBoundingSet=~CAP_B CAP_C</programlisting> configuration or lifetime guarantees, please consider using <citerefentry><refentrytitle>tmpfiles.d</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para> + <para>The directories defined by these options are always created under the standard paths used by systemd + (<filename>/var</filename>, <filename>/run</filename>, <filename>/etc</filename>, …). If the service needs + directories in a different location, a different mechanism has to be used to create them.</para> + + <para><citerefentry><refentrytitle>tmpfiles.d</refentrytitle><manvolnum>5</manvolnum></citerefentry> provides + functionality that overlaps with these options. Using these options is recommended, because the lifetime of + the directories is tied directly to the lifetime of the unit, and it is not necessary to ensure that the + <filename>tmpfiles.d</filename> configuration is executed before the unit is started.</para> + <para>Example: if a system service unit has the following, <programlisting>RuntimeDirectory=foo/bar baz</programlisting> the service manager creates <filename>/run/foo</filename> (if it does not exist), |