shaba/systemd-stable
1
1
Fork 0
mirror of https://github.com/systemd/systemd-stable.git synced 2024-12-23 17:34:00 +03:00
Code

man: document which tmpfiles line types follow symlinks

Browse Source 
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.
This commit is contained in:
Lennart Poettering 2015-04-13 15:18:09 +02:00
parent 48b8aaa827
commit 6a9171d2ec
1 changed files with 20 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
man/tmpfiles.d.xml
View File

@ -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>