X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Ftmpfiles.d.xml;h=4a8e8316cde6a095f30f9c363c456590ad31f05d;hp=e6b4c1bfacb939d0b041571878a8fef337e0eadf;hb=8ab49c12dcab02d9d83e63a93676d4fc8f709516;hpb=5471472d441d9ac48640f11a3b07e6a1fd6d1b63 diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml index e6b4c1bfa..4a8e8316c 100644 --- a/man/tmpfiles.d.xml +++ b/man/tmpfiles.d.xml @@ -42,35 +42,52 @@ 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 temporary files and - directories which usually reside in - /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/ 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 /var/run/user 0755 root root 10d +d /run/user 0755 root root 10d Type @@ -95,19 +112,69 @@ 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 + + x - Ignore a path + Ignore a path + during cleaning. Use this type + to exclude paths from clean-up + as controlled with the Age + parameter. 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 + of normal path + names. r - Remove a path + Remove a file + or directory if it + exists. This may not be used + to remove non-empty + directories, use R for + that. Lines of this type + accept shell-style globs in + place of normal path + names. R - Recursively remove a path + Recursively + remove 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. + + + + 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. @@ -115,10 +182,13 @@ d /var/run/user 0755 root root 10d Mode - The file access mode to use for this - file or directory. If omitted or when set to - - the default is used: 0755 for directories, - 0644 for files. + 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. @@ -127,8 +197,10 @@ d /var/run/user 0755 root root 10d 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 is - used. + 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. @@ -153,10 +225,12 @@ d /var/run/user 0755 root root 10d us - 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. + 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. @@ -175,7 +249,8 @@ d /var/run/uscreens 0755 root root 10d12h See Also - systemd1 + systemd1, + systemd-tmpfiles8