English
Why not create the directories with XXXXXX instead?
`+USER+` is the name of the owner of the directory.
tmpfiles.d is a service for managing temporary files and runtime directories for daemons. In this guideline we mainly concentrate on how it is used to populate `+/run+` and `+/run/lock+`. Since `+/run+` is a `+tmpfs+` filesystem, it and its contents must be recreated on every reboot. For files intended to be created there, this should normally not pose any problems. However, directories will often need to be created ahead of time. This is best done using the tmpfiles.d mechanism.
`+%{_tmpfilesdir}+` expands to `+%{_prefix}/lib/tmpfiles.d+` which is the location that the package's default tmpfile creation scripts should install into. `+%{_tmpfilesdir}/%{name}.conf+` is *not* marked as a `+%config+` file because it is not supposed to be edited by administrators. Administrators can override the package's `+%{name}.conf+` by placing an identically named file in `+/etc/tmpfiles.d/+`, but this should very rarely be needed.
# tmpfiles.d configuration for the /run directory
Source1: %{name}-tmpfiles.conf
[...]
tmpfiles.d configuration
Tmpfiles.d
# This may not be needed if the upstream's install script creates the directories
# Make sure permissions are correct
install -d -m 0755 %{buildroot}/run/%{name}/
This code would need to be implemented in every init script packaged. Using tmpfiles.d we can cut down on the number of places we have to put code like this.
There are multiple ways to try creating the directories but most suffer some disadvantage that tmpfiles.d addresses:
The format of the line is as follows:
`+-+` specifies that aging should not be applied to the contents of the directory. Aging is a mechanism for automated cleanup of files that were not used for a specified length of time. This is mostly useful for directories such as /tmp and is seldom used by packages. Feel free to use aging if it is appropriate for your directory.
Since the init script is run by root, before the daemon drops privileges, why not create the directories there?
`+/run/NAME+` is the filesystem path to create.
Properly labelling the created directories is done automatically by the tmpfiles.d mechanism but would have to be manually done by the init script.
`+PERM+` are the permissions (in the 4-digit octal format) to apply to the directory when it is created.
Overview
Many times, daemons run as an unprivileged user who would not be allowed to create new directories directly into `+/run+`. If the daemon does not drop privileges, then you can patch it to create the files and directories when the daemon starts and submit the patch upstream.
In the spec file, the packager needs to install the tmpfiles.d conf file into the `+%{_tmpfilesdir}+` directory and also make sure the directory is included in the rpm.
%install
mkdir -p %{buildroot}%{_tmpfilesdir}
install -m 0644 %{SOURCE1} %{buildroot}%{_tmpfilesdir}/%{name}.conf