summaryrefslogtreecommitdiffstats
path: root/man/tmpfiles.d.xml
diff options
context:
space:
mode:
Diffstat (limited to 'man/tmpfiles.d.xml')
-rw-r--r--man/tmpfiles.d.xml43
1 files changed, 22 insertions, 21 deletions
diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml
index 15785d1bf2..4ede01c82d 100644
--- a/man/tmpfiles.d.xml
+++ b/man/tmpfiles.d.xml
@@ -531,27 +531,24 @@ w- /proc/sys/vm/swappiness - - - - 10</programlisting></para>
<refsect2>
<title>Mode</title>
- <para>The file access mode to use when creating this file or
- directory. If omitted or when set to <literal>-</literal>, the
- default is used: 0755 for directories, 0644 for all other file
- objects. For <varname>z</varname>, <varname>Z</varname> lines,
- if omitted or when set to <literal>-</literal>, the file access
- mode will not be modified. This parameter is ignored for
- <varname>x</varname>, <varname>r</varname>,
- <varname>R</varname>, <varname>L</varname>, <varname>t</varname>,
- and <varname>a</varname> lines.</para>
-
- <para>Optionally, if prefixed with <literal>~</literal>, the
- access mode is masked based on the already set access bits for
- existing file or directories: if the existing file has all
- executable bits unset, all executable bits are removed from the
- new access mode, too. Similarly, if all read bits are removed
- from the old access mode, they will be removed from the new
- access mode too, and if all write bits are removed, they will be
- removed from the new access mode too. In addition, the
- sticky/SUID/SGID bit is removed unless applied to a
- directory. This functionality is particularly useful in
- conjunction with <varname>Z</varname>.</para>
+ <para>The file access mode to use when creating this file or directory. If omitted or when set to
+ <literal>-</literal>, the default is used: 0755 for directories, 0644 for all other file objects. For
+ <varname>z</varname>, <varname>Z</varname> lines, if omitted or when set to <literal>-</literal>, the
+ file access mode will not be modified. This parameter is ignored for <varname>x</varname>,
+ <varname>r</varname>, <varname>R</varname>, <varname>L</varname>, <varname>t</varname>, and
+ <varname>a</varname> lines.</para>
+
+ <para>Optionally, if prefixed with <literal>~</literal>, the access mode is masked based on the already
+ set access bits for existing file or directories: if the existing file has all executable bits unset,
+ all executable bits are removed from the new access mode, too. Similarly, if all read bits are removed
+ from the old access mode, they will be removed from the new access mode too, and if all write bits are
+ removed, they will be removed from the new access mode too. In addition, the sticky/SUID/SGID bit is
+ removed unless applied to a directory. This functionality is particularly useful in conjunction with
+ <varname>Z</varname>.</para>
+
+ <para>Optionally, if prefixed with <literal>:</literal>, the configured access mode is only used when
+ creating new inodes. If the inode the line refers to already exists, its access mode is left in place
+ unmodified.</para>
</refsect2>
<refsect2>
@@ -571,6 +568,10 @@ w- /proc/sys/vm/swappiness - - - - 10</programlisting></para>
url="https://systemd.io/UIDS-GIDS/#notes-on-resolvability-of-user-and-group-names">Notes on
Resolvability of User and Group Names</ulink> for more information on requirements on system user/group
definitions.</para>
+
+ <para>Optionally, if prefixed with <literal>:</literal>, the configured user/group information is only
+ used when creating new inodes. If the inode the line refers to already exists, its user/group is left
+ in place unmodified.</para>
</refsect2>
<refsect2>