X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Ftmpfiles.d.xml;h=25a7c9ba48351d96b84388c65de4a16a6eca5449;hp=e211d6ded5c3b6691da56f54f96b2cc4e287da12;hb=4b9397474f2c80957fd1cedf885061052333fb25;hpb=b8bb3e8f346468e61dcc7a6aba5e7ac9c623d964 diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml index e211d6ded..25a7c9ba4 100644 --- a/man/tmpfiles.d.xml +++ b/man/tmpfiles.d.xml @@ -42,47 +42,73 @@ tmpfiles.d - Configuration for creation, deletion and cleaning of temporary and volatile files + Configuration for creation, deletion and + cleaning of volatile and temporary files + /usr/lib/tmpfiles.d/*.conf /etc/tmpfiles.d/*.conf + /run/tmpfiles.d/*.conf Description - systemd uses - /etc/tmpfiles.d/ to describe the - creation, cleaning and removal of volatile files and - directories which usually reside in directories such - as /var/run or - /tmp. Each configuration file is - named in the style of - /etc/tmpfiles.d/<program>.conf. + systemd-tmpfiles uses the + configuration files from the above directories to describe the + creation, cleaning and removal of volatile and + temporary files and directories which usually reside + in directories such as /run + or /tmp. Configuration Format + Each configuration file is named in the style of + <program>.conf. Files in + /etc/ override files with the + same name in /usr/lib/. Files in + /run override files with the same + name in /etc/ and + /usr/lib/. Packages should + install their configuration files in + /usr/lib/, files in + /etc/ are reserved for the local + administrator, who may choose to override the + configurations installed from packages. The list of + configuration files are sorted by their filename in + alphabetical order, regardless in which of the + directories they reside, to guarantee that a + configuration file takes precedence over another + configuration file with an alphabetically later + name. + The configuration format is one line per path - containing action, mode, ownership and age + containing action, path, mode, ownership, age and argument fields: - Type Path Mode UID GID Age -d /var/run/user 0755 root root 10d + Type Path Mode UID GID Age Argument +d /run/user 0755 root root 10d - +L /tmp/foobar - - - - /dev/null Type f - Create a file if it doesn't exist yet + Create a file if it doesn't exist yet (optionally writing a short string into it, if the argument parameter is passed) F - Create or truncate a file + Create or truncate a file (optionally writing a short string into it, if the argument parameter is passed) + + + + w + Write the argument parameter to a file, if it exists. @@ -95,6 +121,26 @@ d /var/run/user 0755 root root 10d Create or empty a directory + + p + Create a named pipe (FIFO) if it doesn't exist yet + + + + L + Create a symlink if it doesn't exist yet + + + + c + Create a character device node if it doesn't exist yet + + + + b + Create a block device node if it doesn't exist yet + + x Ignore a path @@ -133,6 +179,27 @@ d /var/run/user 0755 root root 10d place of normal path names. + + + z + Set ownership, access + mode and relabel security context of + a file or directory if it exists. + Lines of this type accept shell-style + globs in place of normal path names. + + + + + Z + Recursively set + ownership, access mode and relabel + security context of a path and + all its subdirectories (if it is a + directory). Lines of this type accept + shell-style globs in place of normal + path names. + @@ -142,8 +209,11 @@ d /var/run/user 0755 root root 10d The file access mode to use when creating this file or directory. If omitted or when set to - the default is used: 0755 for - directories, 0644 for files. This parameter is - ignored for x, r, R lines. + directories, 0644 for all other file + 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. @@ -153,8 +223,9 @@ d /var/run/user 0755 root root 10d 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. . These parameters are ignored for x, - r, R lines. + 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. @@ -179,10 +250,25 @@ d /var/run/user 0755 root root 10d 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. - The age field only applies to lines starting with d, D and x. If omitted or set to - no automatic clean-up is done. + The age field only applies to lines starting with + d, D and x. If omitted or set to - no automatic clean-up + is done. + + + Argument + + For L lines determines the destination + path of the symlink. For c, b determines the + major/minor of the device node, with major and + minor formatted as integers, separated by :, + e.g. "1:3". For f, F, w may be used to specify + a short string that is written to the file, + suffixed by a newline. Ignored for all other + lines. @@ -193,7 +279,7 @@ d /var/run/user 0755 root root 10d /etc/tmpfiles.d/screen.conf example screen needs two directories created at boot with specific modes and ownership. - d /var/run/screens 1777 root root 10d + d /var/run/screens 1777 root root 10d d /var/run/uscreens 0755 root root 10d12h @@ -201,7 +287,8 @@ d /var/run/uscreens 0755 root root 10d12h See Also - systemd1 + systemd1, + systemd-tmpfiles8