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