diff options
| author |   Lennart Poettering <lennart@poettering.net> | 2014-07-01 01:14:11 +0200 |
|---|---|---|
| committer | Lennart Poettering <lennart@poettering.net> | 2014-07-01 01:14:22 +0200 |
| commit | 82a30aae48de73c39b59fbcb810636f7376b7bbc (patch) | |
| tree | 1b21ca826f66341514814775b88e6e46615cce33 | |
| parent | man: add sections about file node types and write access to file-hierarchy(7) (diff) | |
| download | systemd-82a30aae48de73c39b59fbcb810636f7376b7bbc.tar.gz systemd-82a30aae48de73c39b59fbcb810636f7376b7bbc.tar.bz2 systemd-82a30aae48de73c39b59fbcb810636f7376b7bbc.zip | |
man: extend a bit what to expect from the various places apps can store data
| -rw-r--r-- | man/file-hierarchy.xml | 14 |
1 files changed, 8 insertions, 6 deletions
diff --git a/man/file-hierarchy.xml b/man/file-hierarchy.xml index c85df72a1..a1b232d32 100644 --- a/man/file-hierarchy.xml +++ b/man/file-hierarchy.xml @@ -709,15 +709,15 @@ </row> <row> <entry><filename>/run/<replaceable>package</replaceable></filename></entry> - <entry>Runtime data for the package. Packages must be able to create the necessary subdirectories in this tree on their own, since the directory is flushed automatically on boot. Alternatively, a <citerefentry><refentrytitle>tmpfiles.d</refentrytitle><manvolnum>5</manvolnum></citerefentry> fragment may be used to create the necessary directories during boot.</entry> + <entry>Runtime data for the package. Packages must be able to create the necessary subdirectories in this tree on their own, since the directory is flushed automatically on boot. Alternatively, a <citerefentry><refentrytitle>tmpfiles.d</refentrytitle><manvolnum>5</manvolnum></citerefentry> fragment may be used to create the necessary directories during boot. Alternatively, the <varname>RuntimeDirectory=</varname> directive of service units may be used (see <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry> for details.)</entry> </row> <row> <entry><filename>/run/log/<replaceable>package</replaceable></filename></entry> - <entry>Runtime log data for the package.</entry> + <entry>Runtime log data for the package. As above, the package needs to make sure to create this directory if necessary, as it will be flushed on every boot.</entry> </row> <row> <entry><filename>/var/cache/<replaceable>package</replaceable></filename></entry> - <entry>Persistent cache data of the package. If this directory is flushed the application should work correctly on next invocation, though possibly slowed done due to the need to rebuild any local cache files.</entry> + <entry>Persistent cache data of the package. If this directory is flushed the application should work correctly on next invocation, though possibly slowed done due to the need to rebuild any local cache files. The application must be capable of recreating this directory should it be missing and necessary.</entry> </row> <row> <entry><filename>/var/lib/<replaceable>package</replaceable></filename></entry> @@ -725,11 +725,11 @@ </row> <row> <entry><filename>/var/log/<replaceable>package</replaceable></filename></entry> - <entry>Persistent log data of the package.</entry> + <entry>Persistent log data of the package. As above, the package should make sure to create this directory if necessary, as it might be missing.</entry> </row> <row> <entry><filename>/var/spool/<replaceable>package</replaceable></filename></entry> - <entry>Persistent spool/queue data of the package.</entry> + <entry>Persistent spool/queue data of the package. As above, the package should make sure to create this directory if necessary, as it might be missing.</entry> </row> </tbody> </tgroup> @@ -743,7 +743,9 @@ <citerefentry><refentrytitle>hier</refentrytitle><manvolnum>7</manvolnum></citerefentry>, <citerefentry><refentrytitle>systemd-boot-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry>, <citerefentry><refentrytitle>sysctl.d</refentrytitle><manvolnum>5</manvolnum></citerefentry>, - <citerefentry><refentrytitle>pkg-config</refentrytitle><manvolnum>1</manvolnum></citerefentry> + <citerefentry><refentrytitle>tmpfiles.d</refentrytitle><manvolnum>5</manvolnum></citerefentry>, + <citerefentry><refentrytitle>pkg-config</refentrytitle><manvolnum>1</manvolnum></citerefentry>, + <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry> </para> </refsect1> |