X-Git-Url: http://git.ipfire.org/?a=blobdiff_plain;f=man%2Ftmpfiles.d.xml;h=a497b9b4894770b8b5a3dd3203e475a87ee6a35f;hb=f8b68539d0ddda5964d533c2eb9c0d8bff95616b;hp=acad6dcc01e4f2471c4bc47e843ea25f6b3479aa;hpb=3a54a157605bd7d4bf1be05e28201f3d9422cecc;p=thirdparty%2Fsystemd.git
diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml
index acad6dcc01e..a497b9b4894 100644
--- a/man/tmpfiles.d.xml
+++ b/man/tmpfiles.d.xml
@@ -33,9 +33,46 @@
~/.config/user-tmpfiles.d/*.conf$XDG_RUNTIME_DIR/user-tmpfiles.d/*.conf~/.local/share/user-tmpfiles.d/*.conf
-â¦
+â¦/usr/share/user-tmpfiles.d/*.conf
+
+ #Type Path Mode User Group Age Argument
+f /file/to/create mode user group - content
+f+ /file/to/create-or-truncate mode user group - content
+w /file/to/write-to - - - - content
+w+ /file/to/append-to - - - - content
+d /directory/to/create-and-cleanup mode user group cleanup-age -
+D /directory/to/create-and-remove mode user group cleanup-age -
+e /directory/to/cleanup mode user group cleanup-age -
+v /subvolume/to/create mode user group - -
+v /subvolume-or-directory/to/create mode user group - -
+Q /subvolume/to/create mode user group - -
+p /fifo/to/create mode user group - -
+p+ /fifo/to/[re]create mode user group - -
+L /symlink/to/create - - - - symlink/target/path
+L+ /symlink/to/[re]create - - - - symlink/target/path
+c /dev/char-device-to-create mode user group - -
+c+ /dev/char-device-to-[re]create mode user group - -
+b /dev/block-device-to-create mode user group - -
+b+ /dev/block-device-to-[re]create mode user group - -
+C /target/to/create - - - - /source/to/copy
+x /path-or-glob/to/ignore - - - - -
+X /path-or-glob/to/ignore/recursively - - - - -
+r /empty/dir/to/remove - - - - -
+R /dir/to/remove/recursively - - - - -
+z /path-or-glob/to/adjust/mode mode user group - MAC context
+Z /path-or-glob/to/adjust/mode/recursively mode user group - MAC context
+t /path-or-glob/to/set/xattrs - - - - xattrs
+T /path-or-glob/to/set/xattrs/recursively - - - - xattrs
+h /path-or-glob/to/set/attrs - - - - file attrs
+H /path-or-glob/to/set/attrs/recursively - - - - file attrs
+a /path-or-glob/to/set/acls - - - - POSIX ACLs
+a+ /path-or-glob/to/append/acls - - - - POSIX ACLs
+A /path-or-glob/to/set/acls/recursively - - - - POSIX ACLs
+A+ /path-or-glob/to/append/acls/recursively - - - - POSIX ACLs
+
+
@@ -124,25 +161,22 @@ L /tmp/foobar - - - - /dev/null
f
- Create a file if it does not exist yet. If the argument parameter is given and the file did
- not exist yet, it will be written to the file. Does not follow symlinks.
-
-
-
- F
- Create or truncate a file. If the argument
- parameter is given, it will be written to the file. Does not follow symlinks.
-
+ f+
+ f will create a file if it does not exist yet. If the argument
+ parameter is given and the file did not exist yet, it will be written to the file.
+ f+ will create or truncate the file. If the argument parameter is given, it will
+ be written to the file. Does not follow symlinks.w
- 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. Follows
- symlinks.
+ w+
+ Write the argument parameter to a file, if the file exists.
+ If suffixed with +, the line will be appended to the file.
+ If your configuration writes multiple lines to the same file, use w+.
+ 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. Follows symlinks.
@@ -349,67 +383,64 @@ L /tmp/foobar - - - - /dev/null
t
- 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. Does not follow
- symlinks.
+ Set extended attributes, see attr
+ 5 for details. The argument field should take one or more
+ assignment expressions in the form
+ namespace.attribute=value,
+ for examples see below. Lines of this type accept shell-style globs in place of normal path
+ names. This can be useful for setting SMACK labels. Does not follow symlinks.
+
+ Please note that extended attributes settable with this line type are a different concept
+ from the Linux file attributes settable with h/H, see
+ below.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. Does not follow symlinks.
+ Same as t, but operates recursively.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 be set exactly as the following letters. The
- letters aAcCdDeijsStTu select the new
- attributes for the files, see
- chattr
+ Set Linux file/directory attributes. Lines of this type accept shell-style globs in
+ place of normal path names.
+
+ The format of the argument field is [+-=][aAcCdDeijPsStTu]. The prefix
+ + (the default one) causes the attribute(s) to be added; -
+ causes the attribute(s) to be removed; = causes the attributes to be set exactly
+ as the following letters. The letters aAcCdDeijPsStTu select the new attributes
+ for the files, see chattr1 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. Does not follow
- symlinks.
-
+
+ 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. Does not
+ follow symlinks.
+
+ Please note that the Linux file attributes settable with this line type are a different
+ concept from the extended attributes settable with t/T,
+ see above.H
- Recursively set file/directory attributes. Lines
- of this type accept shell-style globs in place of normal
- path names. Does not follow symlinks.
-
+ Sames as h, but operates recursively.aa+
- Set POSIX ACLs (access control lists). If
- suffixed with +, the 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 explicitly 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. Does not follow symlinks.
+ Set POSIX ACLs (access control lists), see acl
+ 5. If suffixed with +, the 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 explicitly 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. Does not follow
+ symlinks.
@@ -499,6 +530,14 @@ w- /proc/sys/vm/swappiness - - - - 10
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.
+
+ This field should generally only reference system users/groups, i.e. users/groups that are
+ guaranteed to be resolvable during early boot. If this field references users/groups that only become
+ resolveable during later boot (i.e. after NIS, LDAP or a similar networked directory service become
+ available), execution of the operations declared by the line will likely fail. Also see Notes on
+ Resolvability of User and Group Names for more information on requirements on system user/group
+ definitions.
@@ -615,7 +654,7 @@ w- /proc/sys/vm/swappiness - - - - 10
%LSystem or user log directory
- In mode, this is the same as $XDG_CONFIG_HOME with /log appended, and /var/log otherwise.
+ In mode, this is the same as $XDG_CONFIG_HOME with /log appended, and /var/log otherwise.%m