From 6a9171d2ec4f2cc1d7850fcb7b076cb75fbd3dd3 Mon Sep 17 00:00:00 2001
From: Lennart Poettering <lennart@poettering.net>
Date: Mon, 13 Apr 2015 15:18:09 +0200
Subject: [PATCH] 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.
---
 man/tmpfiles.d.xml | 38 ++++++++++++++++++++------------------
 1 file changed, 20 insertions(+), 18 deletions(-)

diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml
index 839bb7604b3..a9ef3dffcf3 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>
 
-- 
2.39.2