X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Ftmpfiles.d.xml;h=1c079f64bcbc6e152b39c5bbf442c78111de00f0;hp=8776068a115de8e526d5cb5a6707becab1b11707;hb=23a7f0f721ff4e3b3fd4ed87f7d8e01ebad20093;hpb=24f3a374b9588a6e409ba58b40bdd684050decf3 diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml index 8776068a1..1c079f64b 100644 --- a/man/tmpfiles.d.xml +++ b/man/tmpfiles.d.xml @@ -67,7 +67,7 @@ Configuration Format Each configuration file shall be named in the - style of <program>.conf. + style of <package>.conf. Files in /etc/ override files with the same name in /usr/lib/ and /run/. Files in @@ -79,17 +79,18 @@ administrator, who may use this logic to override the 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 + lexicographic order, regardless in which of the + directories they reside. 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 logged as errors. If the administrator wants to disable a - configuration file supplied by the vendor the + 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 @@ -99,12 +100,16 @@ d /run/user 0755 root root 10d - L /tmp/foobar - - - - /dev/null + Type + + The following line types are understood: + 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 +119,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 +137,33 @@ 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 + + + + m + If the + specified file path exists, + adjust its access mode, group + and user to the specified + values and reset the SELinux + label. If it does not exist, do + nothing. @@ -158,7 +177,25 @@ 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 cleaning. Use this type + to exclude paths from clean-up + as controlled with the Age + parameter. Unlike x, this + parameter will 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 shell-style globs in + place of normal path names. @@ -214,15 +251,66 @@ L /tmp/foobar - - - - /dev/null + + Path + + The file system path specification supports simple specifier + expansion. The following expansions are + understood: + + + Specifiers available + + + + + + + Specifier + Meaning + Details + + + + + %m + Machine ID + The machine ID of the running system, formatted as string. See machine-id5 for more information. + + + %b + Boot ID + The boot ID of the running system, formatted as string. See random4 for more information. + + + %H + Host name + The hostname of the running system. + + + %v + Kernel release + Identical to uname -r output. + + + %% + Escaped % + Single percent sign. + + + +
+ + Mode The file access mode to use when creating this file or directory. If omitted or - when set to - the default is used: 0755 for + when set to -, the default is used: 0755 for directories, 0644 for all other file - objects. For z, Z lines if omitted or when set - to - the file access mode will not be + objects. For z, Z lines, if omitted or when set + to -, the file access mode will not be modified. This parameter is ignored for x, r, R, L lines. @@ -233,8 +321,8 @@ L /tmp/foobar - - - - /dev/null The user and group to use for this file or directory. This 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 - + 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 lines. @@ -244,7 +332,7 @@ L /tmp/foobar - - - - /dev/null The date field, when set, is used to decide what files to delete when cleaning. If a file or directory is older than the current - time minus the age field it is deleted. The + 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: @@ -261,15 +349,20 @@ L /tmp/foobar - - - - /dev/null us - If multiple integers and units are specified the time - values are summed up. + If multiple integers and units are specified, the time + 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 + 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 + 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. @@ -299,13 +392,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