X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Ftmpfiles.d.xml;h=b7397b64b535aa037e0d50f8bf70182f41f27a6e;hp=4a8e8316cde6a095f30f9c363c456590ad31f05d;hb=1532449274704529244071160a61814a451b3501;hpb=777b87e702197ad1f2d0f2a3aea5271d18062c5c diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml index 4a8e8316c..b7397b64b 100644 --- a/man/tmpfiles.d.xml +++ b/man/tmpfiles.d.xml @@ -7,16 +7,16 @@ Copyright 2010 Brandon Philips systemd is free software; you can redistribute it and/or modify it - under the terms of the GNU General Public License as published by - the Free Software Foundation; either version 2 of the License, or + under the terms of the GNU Lesser General Public License as published by + the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. systemd is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - General Public License for more details. + Lesser General Public License for more details. - You should have received a copy of the GNU General Public License + You should have received a copy of the GNU Lesser General Public License along with systemd; If not, see . --> @@ -47,59 +47,74 @@ - /usr/lib/tmpfiles.d/*.conf /etc/tmpfiles.d/*.conf /run/tmpfiles.d/*.conf + /usr/lib/tmpfiles.d/*.conf Description - 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. + 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/ overwrite - files with the same name in /usr/lib/. - Files in /run overwrite 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 - administration, which possibly decides to overwrite the - configurations installed from packages. All files are sorted - by filename in alphabetical order, regardless in which of the - directories they reside, to ensure that a specific - configuration file takes precedence over another file with - an alphabetically later name. - - The configuration format is one line per path - containing action, mode, ownership and age - fields: - - Type Path Mode UID GID Age -d /run/user 0755 root root 10d + Configuration Format + + Each configuration file shall be named in the + style of <program>.conf. + Files in /etc/ override files + with the same name in /usr/lib/ + and /run/. Files in + /run/ override files with the same + name in /usr/lib/. Packages + should install their configuration files in + /usr/lib/. Files in + /etc/ are reserved for the local + 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. + + 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. + + The configuration format is one line per path + containing action, path, mode, ownership, age and argument + fields: + + 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. @@ -117,6 +132,21 @@ d /run/user 0755 root root 10d 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 @@ -158,23 +188,28 @@ d /run/user 0755 root root 10d 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. + Restore + SELinux security context label + and set ownership and access + mode 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. + Recursively + restore SELinux security + context label and set + ownership and access mode 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. @@ -185,10 +220,11 @@ d /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. 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 - 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. @@ -200,7 +236,7 @@ d /run/user 0755 root root 10d 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 lines. + These parameters are ignored for x, r, R, L lines. @@ -231,6 +267,25 @@ d /run/user 0755 root root 10d 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. + + + + 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. @@ -241,7 +296,7 @@ d /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 @@ -250,7 +305,8 @@ d /var/run/uscreens 0755 root root 10d12h See Also systemd1, - systemd-tmpfiles8 + systemd-tmpfiles8, + systemd-delta1