summaryrefslogtreecommitdiff
path: root/man/file-hierarchy.xml
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2014-07-01 01:13:50 +0200
committerLennart Poettering <lennart@poettering.net>2014-07-01 01:14:22 +0200
commitc65b503d01dd61aba6ca0689b1ab151b3279cda6 (patch)
treecba388bb7e99f5ba7c54b32466a1285128e5b451 /man/file-hierarchy.xml
parentee43f49b7889b546fe05a141459d7f1ddf129bd4 (diff)
man: add sections about file node types and write access to file-hierarchy(7)
Diffstat (limited to 'man/file-hierarchy.xml')
-rw-r--r--man/file-hierarchy.xml49
1 files changed, 49 insertions, 0 deletions
diff --git a/man/file-hierarchy.xml b/man/file-hierarchy.xml
index fb72693c05..c85df72a1f 100644
--- a/man/file-hierarchy.xml
+++ b/man/file-hierarchy.xml
@@ -615,6 +615,55 @@
</refsect1>
<refsect1>
+ <title>Unpriviliged Write Access</title>
+
+ <para>Unpriviliged processes generally lack
+ write access to most of the hierarchy.</para>
+
+ <para>The exceptions for normal users are
+ <filename>/tmp</filename>,
+ <filename>/var/tmp</filename>,
+ <filename>/dev/shm</filename>, as well as the home
+ directory <varname>$HOME</varname> (usually found
+ below <filename>/home</filename>) and the runtime
+ directory <varname>$XDG_RUNTIME_DIR</varname> (found
+ below <filename>/run/user</filename>) of the
+ user, which are all writable.</para>
+
+ <para>For unpriviliged system processes only
+ <filename>/tmp</filename>,
+ <filename>/var/tmp</filename> and
+ <filename>/dev/shm</filename> are writable. If an
+ unpriviliged system process needs a private, writable
+ directory in <filename>/var</filename> or
+ <filename>/run</filename>, it is recommended to either
+ create it before dropping priviliges in the daemon
+ code, to create it via
+ <citerefentry><refentrytitle>tmpfiles.d</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+ fragments during boot, or via the
+ <varname>RuntimeDirectory=</varname> directive of
+ service units (see
+ <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+ for details).</para>
+ </refsect1>
+
+ <refsect1>
+ <title>Node Types</title>
+
+ <para>Unix file systems support different types of file
+ nodes, including regular files, directories, symlinks,
+ character and block device nodes, sockets and FIFOs.</para>
+
+ <para>It is strongly recommended that
+ <filename>/dev</filename> is the only location below
+ which device nodes shall be placed. Similar,
+ <filename>/run</filename> shall be the only location
+ to place sockets and FIFOs. Regular files,
+ directories and symlinks may be used in all
+ directories.</para>
+ </refsect1>
+
+ <refsect1>
<title>System Packages</title>
<para>Developers of system packages should follow