X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Ftmpfiles.d.xml;h=839bb7604b3e41b9b04696b7f430f9317671ea59;hp=9fd5913d83052878aeea0f7791845e45cb8a1243;hb=fa3f5fd2d3aebc468c4df216eca18a289aaa7e16;hpb=302fbdf29eb0ad4ca1fe8ee18755edad7db11b37
diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml
index 9fd5913d8..839bb7604 100644
--- a/man/tmpfiles.d.xml
+++ b/man/tmpfiles.d.xml
@@ -118,6 +118,8 @@
d /run/user 0755 root root 10d -
L /tmp/foobar - - - - /dev/null
+ Fields may be enclosed within quotes and contain C-style escapes.
+
Type
@@ -234,7 +236,7 @@
to exclude paths from clean-up as controlled with the Age
parameter. Note that lines of this type do not influence the
effect of r or R
- lines. Lines of this type accept shell-style globs in place
+ lines. Lines of this type accept shell-style globs in place
of normal path names.
@@ -246,7 +248,7 @@
not exclude the content if path is a directory, but only
directory itself. Note that lines of this type do not
influence the effect of r or
- R lines. Lines of this type accept
+ R lines. Lines of this type accept
shell-style globs in place of normal path names.
@@ -273,7 +275,7 @@
Adjust the access mode, group and user, and
restore the SELinux security context of a file or directory,
if it exists. Lines of this type accept shell-style globs in
- place of normal path names.
+ place of normal path names.
@@ -288,16 +290,76 @@
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.
+ 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.
+
+
+
+
+ T
+ 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.
+
+
+
+
+ h
+ Set file/directory attributes. Lines of this type
+ accept shell-style globs in place of normal path names.
+
+ The format of the argument field is [+-=][aAcCdDeijsStTu]
+
+
+ The prefix + (the default one) causes the
+ attribute(s) to be added; - causes the
+ attribute(s) to be removed; =
+ causes the attributes to set exactly as the following letters.
+ The letters aAcCdDeijsStTu select the new
+ attributes for the files, see
+ chattr
+ 1 for further information.
+
+ Passing only = as argument,
+ resets all the file attributes listed above. It has to be pointed
+ out that the = prefix, limits itself to the
+ attributes corresponding to the letters listed here. All other
+ attributes will be left untouched.
+
+
+
+
+
+
+ H
+ Recursively set file/directory attributes. Lines
+ of this type accept shell-style globs in place of normal
+ path names.
+
+
+
+
+ a
+ a+
+ Set POSIX ACLs (access control lists). If
+ suffixed with +, specified entries will
+ be added to the existing set.
+ systemd-tmpfiles 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 explictly 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.
+
+
+
+ A
+ A+
+ Same as a and
+ a+, but recursive.
@@ -381,8 +443,8 @@
if omitted or when set to -, the file access
mode will not be modified. This parameter is ignored for
x, r,
- R, L, t
- lines.
+ R, L, t,
+ and a lines.
Optionally, if prefixed with ~, the
access mode is masked based on the already set access bits for
@@ -404,11 +466,12 @@
may either be a numeric user/group ID or a user or group
name. If omitted or when set to -, the
default 0 (root) is used. For z,
- Z lines, when omitted or when set to -, the
- file ownership will not be modified. These parameters are
- ignored for x, r,
- R, L, t
- lines.
+ Z lines, when omitted or when set to
+ -, the file ownership will not be
+ modified. These parameters are ignored for x,
+ r, R,
+ L, t, and
+ a lines.
@@ -417,23 +480,22 @@
delete when cleaning. If a file or directory is older than the
current time minus the age field, it is deleted. The field
format is a series of integers each followed by one of the
- following postfixes for the respective time units:
-
-
-
- s
- min
- h
- d
- w
- ms
- m
- us
-
+ following postfixes for the respective time units:
+ s,
+ m or min,
+ h,
+ d,
+ w,
+ ms,
+ us,
+ respectively meaning seconds, minutes, hours, days, weeks,
+ milliseconds, and microseconds. Full names of the time units can
+ be used too.
+
If multiple integers and units are specified, the time
- values are summed up. If an integer is given without a unit,
- s is assumed.
+ values are summed. If an integer is given without a unit,
+ s is assumed.
When the age is set to zero, the files are cleaned
@@ -465,7 +527,8 @@
is written to the file, suffixed by a newline. For
C, specifies the source file or
directory. For t determines extended
- attributes to be set. Ignored for all other lines.
+ attributes to be set. For a determines
+ ACL attributes to be set. Ignored for all other lines.
@@ -496,7 +559,13 @@
systemd1,
systemd-tmpfiles8,
systemd-delta1,
- systemd.exec5
+ systemd.exec5,
+ attr5,
+ getfattr1,
+ setfattr1,
+ setfacl1,
+ getfacl1,
+ chattr1