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

man: document that for removal tmpfiles.d prefix is run after suffix

Browse source
This commit is contained in:
Lennart Poettering 2018-10-29 19:41:59 +01:00
parent bdee3f5580
commit ad19c57898
1 changed files with 14 additions and 22 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

36
man/tmpfiles.d.xml
View file

@ -67,28 +67,20 @@
The second variant should be used when it is desirable to make it The second variant should be used when it is desirable to make it
easy to override just this part of configuration.</para> easy to override just this part of configuration.</para>
<para>Files in <filename>/etc/tmpfiles.d</filename> override files <para>Files in <filename>/etc/tmpfiles.d</filename> override files with the same name in
with the same name in <filename>/usr/lib/tmpfiles.d</filename> and <filename>/usr/lib/tmpfiles.d</filename> and <filename>/run/tmpfiles.d</filename>. Files in
<filename>/run/tmpfiles.d</filename>. Files in <filename>/run/tmpfiles.d</filename> override files with the same name in
<filename>/run/tmpfiles.d</filename> override files with the same <filename>/usr/lib/tmpfiles.d</filename>. Packages should install their configuration files in
name in <filename>/usr/lib/tmpfiles.d</filename>. Packages should <filename>/usr/lib/tmpfiles.d</filename>. Files in <filename>/etc/tmpfiles.d</filename> are reserved for the local
install their configuration files in administrator, who may use this logic to override the configuration files installed by vendor packages. All
<filename>/usr/lib/tmpfiles.d</filename>. Files in configuration files are sorted by their filename in lexicographic order, regardless of which of the directories
<filename>/etc/tmpfiles.d</filename> are reserved for the local they reside in. If multiple files specify the same path, the entry in the file with the lexicographically earliest
administrator, who may use this logic to override the name will be applied. All other conflicting entries will be logged as errors. When two lines are prefix path and
configuration files installed by vendor packages. All suffix path of each other, then the prefix line is always created first, the suffix later (and if removal applies
configuration files are sorted by their filename in lexicographic to the line, the order is reversed: the suffix is removed first, the prefix later). Lines that take globs are
order, regardless of which of the directories they reside in. If applied after those accepting no globs. If multiple operations shall be applied on the same file, (such as ACL,
multiple files specify the same path, the entry in the file with xattr, file attribute adjustments), these are always done in the same fixed order. Otherwise, the files/directories
the lexicographically earliest name will be applied. All other are processed in the order they are listed.</para>
conflicting entries will be logged as errors. When two lines are
prefix and suffix of each other, then the prefix is always
processed first, the suffix later. Lines that take globs are
applied after those accepting no globs. If multiple operations
shall be applied on the same file, (such as ACL, xattr, file
attribute adjustments), these are always done in the same fixed
order. Otherwise, the files/directories are processed in the order
they are listed.</para>
<para>If the administrator wants to disable a configuration file <para>If the administrator wants to disable a configuration file
supplied by the vendor, the recommended way is to place a symlink supplied by the vendor, the recommended way is to place a symlink