picnoir
/
Systemd
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

man: highlight the different concepts behind h/H and t/T 

Fixes: #13151
This commit is contained in:
Lennart Poettering 2019-07-24 09:59:38 +02:00 committed by Zbigniew Jędrzejewski-Szmek
parent 544ad34257
commit f3d3a9ca07
1 changed files with 34 additions and 33 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

67
man/tmpfiles.d.xml
View File

@ -380,63 +380,64 @@ L /tmp/foobar - - - - /dev/null</programlisting>
<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. Does not follow
symlinks.</para></listitem>
<listitem><para>Set extended attributes, see <citerefentry
project='man-pages'><refentrytitle>attr</refentrytitle>
<manvolnum>5</manvolnum></citerefentry> for details. The argument field should take one or more
assignment expressions in the form
<replaceable>namespace</replaceable>.<replaceable>attribute</replaceable>=<replaceable>value</replaceable>,
for examples see below. Lines of this type accept shell-style globs in place of normal path
names. This can be useful for setting SMACK labels. Does not follow symlinks.</para>
<para>Please note that extended attributes settable with this line type are a different concept
from the Linux file attributes settable with <varname>h</varname>/<varname>H</varname>, see
below.</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. Does not follow symlinks. </para></listitem>
<listitem><para>Same as <varname>t</varname>, but operates recursively.</para></listitem>
</varlistentry>
<varlistentry>
<term><varname>h</varname></term>
<listitem><para>Set file/directory attributes. Lines of this type
accept shell-style globs in place of normal path names.</para>
<listitem><para>Set Linux file/directory attributes. Lines of this type accept shell-style globs in
place of normal path names.</para>
<para>The format of the argument field is <varname>[+-=][aAcCdDeijPsStTu] </varname>. The prefix
<para>The format of the argument field is <varname>[+-=][aAcCdDeijPsStTu]</varname>. The prefix
<varname>+</varname> (the default one) causes the attribute(s) to be added; <varname>-</varname>
causes the attribute(s) to be removed; <varname>=</varname> causes the attributes to be set exactly
as the following letters. The letters <literal>aAcCdDeijPsStTu</literal> select the new attributes
for the files, see <citerefentry project='man-pages'><refentrytitle>chattr</refentrytitle>
<manvolnum>1</manvolnum></citerefentry> for further information.
</para>
<para>Passing only <varname>=</varname> as argument 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. Does not follow
symlinks.</para>
</listitem>
<para>Passing only <varname>=</varname> as argument 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. Does not
follow symlinks.</para>
<para>Please note that the Linux file attributes settable with this line type are a different
concept from the extended attributes settable with <varname>t</varname>/<varname>T</varname>,
see above.</para></listitem>
</varlistentry>
<varlistentry>
<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. Does not follow symlinks.
</para></listitem>
<listitem><para>Sames as <varname>h</varname>, but operates recursively.</para></listitem>
</varlistentry>
<varlistentry>
<term><varname>a</varname></term>
<term><varname>a+</varname></term>
<listitem><para>Set POSIX ACLs (access control lists). If
suffixed with <varname>+</varname>, the specified entries will
be added to the existing set.
<command>systemd-tmpfiles</command> will automatically add
the required base entries for user and group based on the
access mode of the file, unless base entries already exist
or are explicitly specified. The mask will be added if not
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. Does not follow symlinks.</para></listitem>
<listitem><para>Set POSIX ACLs (access control lists), see <citerefentry
project='man-pages'><refentrytitle>acl</refentrytitle>
<manvolnum>5</manvolnum></citerefentry>. If suffixed with <varname>+</varname>, the specified
entries will be added to the existing set. <command>systemd-tmpfiles</command> will automatically
add the required base entries for user and group based on the access mode of the file, unless base
entries already exist or are explicitly specified. The mask will be added if not 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. Does not follow
symlinks.</para></listitem>
</varlistentry>
<varlistentry>