X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Ftmpfiles.d.xml;h=4f2e6406a882807da2166e02356af173d28dc76c;hp=6b2753549c51759907218dbece78ac23a0518ebd;hb=ebf4e8013b2928fdcfa6008ee6559e8c7e1fd60b;hpb=1554afae546f6cfb8ac85e36300d7bf608886780
diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml
index 6b2753549..4f2e6406a 100644
--- a/man/tmpfiles.d.xml
+++ b/man/tmpfiles.d.xml
@@ -108,11 +108,11 @@
filename in lexicographic order, regardless of which
of the directories they reside in. If multiple files
specify the same path, the entry in the file with the
- lexicographically earliest name will be applied, all
- all other conflicting entries will be logged as
+ lexicographically earliest name will be applied.
+ All other 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. Otherwise the files/directories are
+ suffix later. Otherwise, the files/directories are
processed in the order they are listed.
If the administrator wants to disable a
@@ -175,7 +175,7 @@ L /tmp/foobar - - - - /dev/null
exist yet. If suffixed with
+ and a
file already exists where the
- pipe is to be created it will
+ pipe is to be created, it will
be removed and be replaced by
the pipe.
@@ -188,10 +188,14 @@ L /tmp/foobar - - - - /dev/null
yet. If suffixed with
+ and a
file already exists where the
- symlink is to be created it
+ symlink is to be created, it
will be removed and be
replaced by the
- symlink.
+ symlink. If the argument is omitted,
+ symlinks to files with the same name
+ residing in the directory
+ /usr/share/factory/
+ are created.
@@ -203,10 +207,15 @@ L /tmp/foobar - - - - /dev/null
suffixed with
+ and a
file already exists where the
- device node is to be created
+ device node is to be created,
it will be removed and be
replaced by the device
- node.
+ node. It is recommended to suffix this
+ entry with an exclamation mark to only
+ create static device nodes at boot,
+ as udev will not manage static device
+ nodes that are created at runtime.
+
@@ -217,15 +226,33 @@ L /tmp/foobar - - - - /dev/null
exist yet. If suffixed with
+ and a
file already exists where the
- device node is to be created
+ device node is to be created,
it will be removed and be
replaced by the device
- node.
+ node. It is recommended to suffix this
+ entry with an exclamation mark to only
+ create static device nodes at boot,
+ as udev will not manage static device
+ nodes that are created at runtime.
+
C
- Recursively copy a file or directory, if the destination files or directories don't exist yet.
+ Recursively
+ copy a file or directory, if
+ the destination files or
+ directories do not exist
+ yet. Note that this command
+ will not descend into
+ subdirectories if the
+ destination directory already
+ exists. Instead, the entire
+ copy operation is
+ skipped. If the argument is omitted,
+ files from the source directory
+ /usr/share/factory/
+ with the same name are copied.
@@ -316,6 +343,25 @@ L /tmp/foobar - - - - /dev/null
normal path
names.
+
+
+ t
+ Set extended
+ attributes on item. It may be
+ used in conjunction with other
+ types (only d,
+ D, f,
+ F, L,
+ p, c,
+ b, makes sense).
+ If used as a standalone line, then
+ systemd-tmpfiles
+ will try to set extended
+ attributes on specified path.
+ This can be especially used to set
+ SMACK labels.
+
+
If the exclamation mark is used, this
@@ -403,20 +449,20 @@ r! /tmp/.X[0-9]*-lock
will not be modified. This parameter is
ignored for x,
r, R,
- L lines.
+ L, t lines.
Optionally, if prefixed with
- ~ the access mode is masked
+ ~, 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 then all
+ file has all executable bits unset, all
executable bits are removed from the new
- access mode, too. Similar, if all read bits
- are removed from the old access mode they will
+ 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/gid bit is removed unless
+ addition, the sticky/SUID/SGID bit is removed unless
applied to a directory. This
functionality is particularly useful in
conjunction with Z.
@@ -435,8 +481,8 @@ r! /tmp/.X[0-9]*-lock
ownership will not be modified. These
parameters are ignored for
x, r,
- R, L
- lines.
+ R, L,
+ t lines.
@@ -499,9 +545,9 @@ r! /tmp/.X[0-9]*-lock
and w may be used to
specify a short string that is written to the
file, suffixed by a newline. For
- C specifies the source file
- or directory. Ignored for all other
- lines.
+ C, specifies the source file
+ or directory. For t determines
+ extended attributes to be set. Ignored for all other lines.
@@ -513,7 +559,8 @@ r! /tmp/.X[0-9]*-lock
screen needs two directories created at boot with specific modes and ownership.
d /run/screens 1777 root root 10d
-d /run/uscreens 0755 root root 10d12h
+d /run/uscreens 0755 root root 10d12h
+t /run/screen - - - - user.name="John Smith" security.SMACK64=screen
/etc/tmpfiles.d/abrt.conf example