X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Ftmpfiles.d.xml;h=2872cc0add463e4d484e40a4c4e355bff68eda21;hp=75d4bcd695796e6f2e13b03d4721a4c161737581;hb=7b4977254cdc1203b44211e00cdb3a0c318cfcf2;hpb=0e25e94ea72ca3db70484014280ddb709840f952
diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml
index 75d4bcd69..2872cc0ad 100644
--- a/man/tmpfiles.d.xml
+++ b/man/tmpfiles.d.xml
@@ -80,16 +80,17 @@
configuration files installed by vendor packages. All
configuration files are sorted by their filename in
alphabetical order, regardless in which of the
- directories they reside, to guarantee that a specific
- configuration file takes precedence over another file
- with an alphabetically later name
+ directories they reside. If multiple files specify the
+ same path, the entry in the file with the alphabetically
+ earliest name will be applied, all all other conflicting
+ entries logged as errors.
If the administrator wants to disable a
configuration file supplied by the vendor the
recommended way is to place a symlink to
/dev/null in
/etc/tmpfiles.d/ bearing the
- same file name.
+ same filename.
The configuration format is one line per path
containing action, path, mode, ownership, age and argument
@@ -104,7 +105,7 @@ L /tmp/foobar - - - - /dev/null
f
- Create a file if it doesn't exist yet (optionally writing a short string into it, if the argument parameter is passed)
+ Create a file if it does not exist yet (optionally writing a short string into it, if the argument parameter is passed)
@@ -114,12 +115,15 @@ L /tmp/foobar - - - - /dev/null
w
- Write the argument parameter to a file, if it exists.
+ Write the argument parameter to a file, if 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.
d
- Create a directory if it doesn't exist yet
+ Create a directory if it does not exist yet
@@ -129,22 +133,22 @@ L /tmp/foobar - - - - /dev/null
p
- Create a named pipe (FIFO) if it doesn't exist yet
+ Create a named pipe (FIFO) if it does not exist yet
L
- Create a symlink if it doesn't exist yet
+ Create a symlink if it does not exist yet
c
- Create a character device node if it doesn't exist yet
+ Create a character device node if it does not exist yet
b
- Create a block device node if it doesn't exist yet
+ Create a block device node if it does not exist yet
@@ -158,7 +162,22 @@ L /tmp/foobar - - - - /dev/null
effect of r or R lines. Lines
of this type accept
shell-style globs in place of
- of normal path
+ normal path
+ names.
+
+
+
+ X
+ Ignore a path
+ during cleanup. Use this type
+ to prevent path removal as
+ controlled with the Age parameter.
+ Note that if path is a directory,
+ content of a directory is not
+ excluded from clean-up, only
+ directory itself. Lines of this
+ type accept shell-style globs
+ in place of normal path
names.
@@ -262,11 +281,22 @@ L /tmp/foobar - - - - /dev/null
If multiple integers and units are specified the time
- values are summed up.
+ values are summed up. If an integer is given without a unit,
+ s is assumed.
+
+
+ When the age is set to zero, the files are cleaned
+ unconditionally.
The age field only applies to lines starting with
d, D and x. If omitted or set to - no automatic clean-up
is done.
+
+ If the age field starts with a tilde
+ character (~) the clean-up is only applied to
+ files and directories one level inside the
+ directory specified, but not the files and
+ directories immediately inside it.
@@ -293,13 +323,21 @@ L /tmp/foobar - - - - /dev/null
d /var/run/screens 1777 root root 10d
d /var/run/uscreens 0755 root root 10d12h
+
+ /etc/tmpfiles.d/abrt.conf example
+ abrt needs a directory created at boot with specific mode and ownership and its content should be preserved.
+
+ d /var/tmp/abrt 0755 abrt abrt
+x /var/tmp/abrt/*
+
See Also
systemd1,
- systemd-tmpfiles8
+ systemd-tmpfiles8,
+ systemd-delta1