summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2015-04-13 15:18:09 +0200
committerLennart Poettering <lennart@poettering.net>2015-04-13 15:23:52 +0200
commit6a9171d2ec4f2cc1d7850fcb7b076cb75fbd3dd3 (patch)
tree2af796259e316c07201c4177abd0012a22579399
parent48b8aaa82724bc2d8440470f414fb0d2416f29c7 (diff)
man: document which tmpfiles line types follow symlinks
Generally, we will not follow symlinks, except for "w". Avoid documentation for now for fifo, device node, directory lines, which currently follow symlinks but better shouldn't.
-rw-r--r--man/tmpfiles.d.xml38
1 files changed, 20 insertions, 18 deletions
diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml
index 839bb7604b..a9ef3dffcf 100644
--- a/man/tmpfiles.d.xml
+++ b/man/tmpfiles.d.xml
@@ -133,13 +133,13 @@
<term><varname>f</varname></term>
<listitem><para>Create a file if it does not exist yet. If
the argument parameter is given, it will be written to the
- file.</para></listitem>
+ file. Does not follow symlinks.</para></listitem>
</varlistentry>
<varlistentry>
<term><varname>F</varname></term>
<listitem><para>Create or truncate a file. If the argument
- parameter is given, it will be written to the file.</para>
+ parameter is given, it will be written to the file. Does not follow symlinks.</para>
</listitem>
</varlistentry>
@@ -149,7 +149,8 @@
the file exists. Lines of this type accept shell-style
globs in place of normal path names. The argument parameter
will be written without a trailing newline. C-style
- backslash escapes are interpreted.</para></listitem>
+ backslash escapes are interpreted. Follows
+ symlinks.</para></listitem>
</varlistentry>
<varlistentry>
@@ -227,7 +228,7 @@
copy operation is skipped. If the argument is omitted, files
from the source directory
<filename>/usr/share/factory/</filename> with the same name
- are copied.</para></listitem>
+ are copied. Does not follow symlinks.</para></listitem>
</varlistentry>
<varlistentry>
@@ -259,7 +260,7 @@
This may not be used to remove non-empty directories, use
<varname>R</varname> for that. Lines of this type accept
shell-style globs in place of normal path
- names.</para></listitem>
+ names. Does not follow symlinks.</para></listitem>
</varlistentry>
<varlistentry>
@@ -267,7 +268,7 @@
<listitem><para>Recursively remove a path and all its
subdirectories (if it is a directory). Lines of this type
accept shell-style globs in place of normal path
- names.</para></listitem>
+ names. Does not follow symlinks.</para></listitem>
</varlistentry>
<varlistentry>
@@ -275,7 +276,7 @@
<listitem><para>Adjust the access mode, group and user, and
restore the SELinux security context of a file or directory,
if it exists. Lines of this type accept shell-style globs in
- place of normal path names.</para></listitem>
+ place of normal path names. Does not follow symlinks.</para></listitem>
</varlistentry>
<varlistentry>
@@ -284,24 +285,24 @@
user, and restore the SELinux security context of a file or
directory if it exists, as well as of its subdirectories and
the files contained therein (if applicable). Lines of this
- type accept shell-style globs in place of normal path names.
- </para></listitem>
+ type accept shell-style globs in place of normal path
+ names. Does not follow symlinks. </para></listitem>
</varlistentry>
<varlistentry>
<term><varname>t</varname></term>
<listitem><para>Set extended attributes. Lines of this type
accept shell-style globs in place of normal path names.
- This can be useful for setting SMACK labels.
- </para></listitem>
+ This can be useful for setting SMACK labels. Does not follow
+ symlinks.</para></listitem>
</varlistentry>
<varlistentry>
<term><varname>T</varname></term>
<listitem><para>Recursively set extended attributes. Lines
of this type accept shell-style globs in place of normal
- path names. This can be useful for setting SMACK labels.
- </para></listitem>
+ path names. This can be useful for setting SMACK
+ labels. Does not follow symlinks. </para></listitem>
</varlistentry>
<varlistentry>
@@ -325,9 +326,9 @@
resets all the file attributes listed above. It has to be pointed
out that the <varname>=</varname> prefix, limits itself to the
attributes corresponding to the letters listed here. All other
- attributes will be left untouched.
- </para>
+ attributes will be left untouched.</para>
+ <para>Does not follow symlinks.</para>
</listitem>
</varlistentry>
@@ -335,7 +336,7 @@
<term><varname>H</varname></term>
<listitem><para>Recursively set file/directory attributes. Lines
of this type accept shell-style globs in place of normal
- path names.
+ path names. Does not follow symlinks.
</para></listitem>
</varlistentry>
@@ -352,14 +353,15 @@
specified explicitly or already present. Lines of this type
accept shell-style globs in place of normal path names. This
can be useful for allowing additional access to certain
- files.</para></listitem>
+ files. Does not follow symlinks.</para></listitem>
</varlistentry>
<varlistentry>
<term><varname>A</varname></term>
<term><varname>A+</varname></term>
<listitem><para>Same as <varname>a</varname> and
- <varname>a+</varname>, but recursive.</para></listitem>
+ <varname>a+</varname>, but recursive. Does not follow
+ symlinks.</para></listitem>
</varlistentry>
</variablelist>