tmpfiles.d
systemd
Documentation
Brandon
Philips
brandon@ifup.org
tmpfiles.d
5
tmpfiles.d
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-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
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
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.
Example
/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/uscreens 0755 root root 10d12h
See Also
systemd1,
systemd-tmpfiles8