X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Ftmpfiles.d.xml;h=7f4c45c9600c13cdd877e685976104bac307fa46;hp=5ff53ef76645ad31d1dec4ceac0b1623ad80d246;hb=bbc732830876ce75a95c57ccf8677f74e4569efc;hpb=4149f86d816fc0fef41d35de5beb09bfe81e0d6a diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml index 5ff53ef76..7f4c45c96 100644 --- a/man/tmpfiles.d.xml +++ b/man/tmpfiles.d.xml @@ -42,88 +42,172 @@ tmpfiles.d - configuration for creation, deletion and cleaning of tmpfiles + 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 - 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 - - - - type - - - f - create a file - - - - F - truncate a file - - - + 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 + + + Type + + + f + Create a file if it doesn't exist yet + + + + F + Create or truncate a file + + + + d + Create a directory if it doesn't exist yet + + + + D + Create or empty a directory + + + + p + Create a named pipe (FIFO) if it doesn't exist yet + + + + x + 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 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 and all its + subdirectories (if it is a + directory). Lines of this type + accept shell-style globs in + place of normal path + names. + + + + + + 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 + directories, 0644 for files. This parameter is + ignored for x, r, R lines. + + + + UID, GID + + 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. . These parameters are ignored for x, + r, R lines. + + + + Age + 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 + field format is a series of integers each + followed by one of the following + postfixes for the respective time units: + + + + s + min + h d - create a directory - - - - D - truncate a directory - - - - x - ignore the path - - - - r - remove the path - - - - R - recursively remove the path - - - - - - age - 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 field format is an integer followed by one of the following postfixes: - - sec - s - min - hr - h - d - w - msec - ms - m - usec - us - - + w + ms + m + 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. + @@ -134,15 +218,15 @@ d /var/run/user 0755 root root 10d screen needs two directories created at boot with specific modes and ownership. d /var/run/screens 1777 root root 10d -d /var/run/uscreens 0755 root root 10d - +d /var/run/uscreens 0755 root root 10d12h See Also - systemd1 + systemd1, + systemd-tmpfiles8