diff options
author | Lennart Poettering <lennart@poettering.net> | 2019-07-24 09:59:38 +0200 |
---|---|---|
committer | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2019-07-24 11:41:35 +0200 |
commit | f3d3a9ca0734c298cc3bf08f8c4907dd19ee9939 (patch) | |
tree | 645bd47c3de5b86c0e17fced8e8a4b177526708f /man | |
parent | 544ad342579e0f80830a42f4fdd1dee08b25d688 (diff) | |
download | systemd-f3d3a9ca0734c298cc3bf08f8c4907dd19ee9939.tar.gz systemd-f3d3a9ca0734c298cc3bf08f8c4907dd19ee9939.tar.bz2 systemd-f3d3a9ca0734c298cc3bf08f8c4907dd19ee9939.zip |
man: highlight the different concepts behind h/H and t/T
Fixes: #13151
Diffstat (limited to 'man')
-rw-r--r-- | man/tmpfiles.d.xml | 67 |
1 files changed, 34 insertions, 33 deletions
diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml index f097045b7b..dce05c364f 100644 --- a/man/tmpfiles.d.xml +++ b/man/tmpfiles.d.xml @@ -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> |