2010-11-05 03:31:07 +07:00
<?xml version="1.0"?>
<!-- * - nxml - * -->
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<!--
This file is part of systemd.
Copyright 2010 Brandon Philips
systemd is free software; you can redistribute it and/or modify it
2012-04-12 05:20:58 +07:00
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
2010-11-05 03:31:07 +07:00
(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
2012-04-12 05:20:58 +07:00
Lesser General Public License for more details.
2010-11-05 03:31:07 +07:00
2012-04-12 05:20:58 +07:00
You should have received a copy of the GNU Lesser General Public License
2010-11-05 03:31:07 +07:00
along with systemd; If not, see <http: / / w w w . g n u . o r g / l i c e n s e s /> .
-->
<refentry id= "tmpfiles.d" >
<refentryinfo >
<title > tmpfiles.d</title>
<productname > systemd</productname>
<authorgroup >
<author >
<contrib > Documentation</contrib>
<firstname > Brandon</firstname>
<surname > Philips</surname>
<email > brandon@ifup.org</email>
</author>
</authorgroup>
</refentryinfo>
<refmeta >
<refentrytitle > tmpfiles.d</refentrytitle>
<manvolnum > 5</manvolnum>
</refmeta>
<refnamediv >
<refname > tmpfiles.d</refname>
2011-02-13 21:08:15 +07:00
<refpurpose > Configuration for creation, deletion and
cleaning of volatile and temporary files</refpurpose>
2010-11-05 03:31:07 +07:00
</refnamediv>
2010-11-22 02:41:00 +07:00
<refsynopsisdiv >
<para > <filename > /etc/tmpfiles.d/*.conf</filename> </para>
2011-04-26 02:38:21 +07:00
<para > <filename > /run/tmpfiles.d/*.conf</filename> </para>
2012-03-14 20:25:05 +07:00
<para > <filename > /usr/lib/tmpfiles.d/*.conf</filename> </para>
2010-11-22 02:41:00 +07:00
</refsynopsisdiv>
2010-11-05 03:31:07 +07:00
<refsect1 >
<title > Description</title>
2012-06-10 23:32:11 +07:00
<para > <command > systemd-tmpfiles</command> 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 <filename > /run</filename>
or <filename > /tmp</filename> .</para>
2010-11-05 03:31:07 +07:00
</refsect1>
<refsect1 >
2012-06-10 23:32:11 +07:00
<title > Configuration Format</title>
2010-11-05 03:31:07 +07:00
2012-06-10 23:26:11 +07:00
<para > Each configuration file shall be named in the
style of <filename > < program> .conf</filename> .
Files in <filename > /etc/</filename> override files
with the same name in <filename > /usr/lib/</filename>
and <filename > /run/</filename> . Files in
<filename > /run/</filename> override files with the same
name in <filename > /usr/lib/</filename> . Packages
should install their configuration files in
<filename > /usr/lib/</filename> . Files in
2012-01-17 21:04:12 +07:00
<filename > /etc/</filename> are reserved for the local
2012-06-10 23:26:11 +07:00
administrator, who may use this logic to override the
configuration files installed by vendor packages. All
2012-01-17 21:04:12 +07:00
configuration files are sorted by their filename in
alphabetical order, regardless in which of the
2012-06-10 23:26:11 +07:00
directories they reside, to guarantee that a specific
configuration file takes precedence over another file
with an alphabetically later name</para>
<para > If the administrator wants to disable a
configuration file supplied by the vendor the
recommended way is to place a symlink to
<filename > /dev/null</filename> in
<filename > /etc/tmpfiles.d/</filename> bearing the
same file name.</para>
2011-04-26 02:38:21 +07:00
2012-06-10 23:32:11 +07:00
<para > The configuration format is one line per path
containing action, path, mode, ownership, age and argument
fields:</para>
2010-11-11 05:01:20 +07:00
2012-01-17 21:04:12 +07:00
<programlisting > Type Path Mode UID GID Age Argument
d /run/user 0755 root root 10d -
L /tmp/foobar - - - - /dev/null</programlisting>
2010-11-11 05:01:20 +07:00
<refsect2 >
2010-11-19 22:14:52 +07:00
<title > Type</title>
2010-11-11 05:01:20 +07:00
<variablelist >
<varlistentry >
<term > <varname > f</varname> </term>
2012-01-18 22:39:04 +07:00
<listitem > <para > Create a file if it doesn't exist yet (optionally writing a short string into it, if the argument parameter is passed)</para> </listitem>
2010-11-11 05:01:20 +07:00
</varlistentry>
<varlistentry >
<term > <varname > F</varname> </term>
2012-01-18 22:39:04 +07:00
<listitem > <para > Create or truncate a file (optionally writing a short string into it, if the argument parameter is passed)</para> </listitem>
</varlistentry>
<varlistentry >
<term > <varname > w</varname> </term>
<listitem > <para > Write the argument parameter to a file, if it exists.</para> </listitem>
2010-11-11 05:01:20 +07:00
</varlistentry>
<varlistentry >
<term > <varname > d</varname> </term>
2010-11-22 02:41:00 +07:00
<listitem > <para > Create a directory if it doesn't exist yet</para> </listitem>
2010-11-11 05:01:20 +07:00
</varlistentry>
<varlistentry >
<term > <varname > D</varname> </term>
2010-11-22 02:41:00 +07:00
<listitem > <para > Create or empty a directory</para> </listitem>
2010-11-11 05:01:20 +07:00
</varlistentry>
2011-07-12 08:56:56 +07:00
<varlistentry >
<term > <varname > p</varname> </term>
<listitem > <para > Create a named pipe (FIFO) if it doesn't exist yet</para> </listitem>
</varlistentry>
2012-01-17 21:04:12 +07:00
<varlistentry >
<term > <varname > L</varname> </term>
<listitem > <para > Create a symlink if it doesn't exist yet</para> </listitem>
</varlistentry>
<varlistentry >
<term > <varname > c</varname> </term>
<listitem > <para > Create a character device node if it doesn't exist yet</para> </listitem>
</varlistentry>
<varlistentry >
<term > <varname > b</varname> </term>
<listitem > <para > Create a block device node if it doesn't exist yet</para> </listitem>
</varlistentry>
2010-11-11 05:01:20 +07:00
<varlistentry >
<term > <varname > x</varname> </term>
2011-02-12 15:31:25 +07:00
<listitem > <para > 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.</para> </listitem>
2010-11-11 05:01:20 +07:00
</varlistentry>
<varlistentry >
<term > <varname > r</varname> </term>
2011-02-12 15:31:25 +07:00
<listitem > <para > 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.</para> </listitem>
2010-11-11 05:01:20 +07:00
</varlistentry>
<varlistentry >
<term > <varname > R</varname> </term>
2011-02-12 15:31:25 +07:00
<listitem > <para > 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.</para> </listitem>
2010-11-11 05:01:20 +07:00
</varlistentry>
2011-12-16 05:04:37 +07:00
2011-12-17 00:27:35 +07:00
<varlistentry >
<term > <varname > z</varname> </term>
2012-03-13 03:51:39 +07:00
<listitem > <para > 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.
2011-12-17 00:27:35 +07:00
</para> </listitem>
</varlistentry>
2011-12-16 05:04:37 +07:00
<varlistentry >
<term > <varname > Z</varname> </term>
2012-03-13 03:51:39 +07:00
<listitem > <para > 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.</para> </listitem>
2011-12-16 05:04:37 +07:00
</varlistentry>
2010-11-11 05:01:20 +07:00
</variablelist>
</refsect2>
<refsect2 >
2010-11-19 22:14:52 +07:00
<title > Mode</title>
2011-02-12 15:31:25 +07:00
<para > The file access mode to use when
creating this file or directory. If omitted or
when set to - the default is used: 0755 for
2012-01-17 21:04:12 +07:00
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.</para>
2010-11-19 22:14:52 +07:00
</refsect2>
<refsect2 >
<title > UID, GID</title>
<para > 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
2011-02-12 15:31:25 +07:00
omitted or when set to - the default 0 (root)
2011-12-17 00:27:35 +07:00
is used. For z, Z lines when omitted or when set to -
2011-12-17 00:00:11 +07:00
the file ownership will not be modified.
2012-01-17 21:04:12 +07:00
These parameters are ignored for x, r, R, L lines.</para>
2010-11-19 22:14:52 +07:00
</refsect2>
<refsect2 >
<title > Age</title>
2010-11-11 05:01:20 +07:00
<para > 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:</para>
<variablelist >
<varlistentry >
<term > <varname > s</varname> </term>
<term > <varname > min</varname> </term>
<term > <varname > h</varname> </term>
<term > <varname > d</varname> </term>
<term > <varname > w</varname> </term>
<term > <varname > ms</varname> </term>
<term > <varname > m</varname> </term>
<term > <varname > us</varname> </term> </varlistentry>
</variablelist>
2010-11-05 03:31:07 +07:00
2011-04-26 02:38:21 +07:00
<para > If multiple integers and units are specified the time
values are summed up.</para>
2010-11-05 03:31:07 +07:00
2011-04-26 02:38:21 +07:00
<para > The age field only applies to lines starting with
d, D and x. If omitted or set to - no automatic clean-up
is done.</para>
2012-06-20 14:05:50 +07:00
<para > 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.</para>
2010-11-11 05:01:20 +07:00
</refsect2>
2010-11-05 03:31:07 +07:00
2012-01-17 21:04:12 +07:00
<refsect2 >
<title > Argument</title>
<para > 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 :,
2012-01-18 22:39:04 +07:00
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.</para>
2012-01-17 21:04:12 +07:00
</refsect2>
2010-11-05 03:31:07 +07:00
</refsect1>
<refsect1 >
<title > Example</title>
<example >
<title > /etc/tmpfiles.d/screen.conf example</title>
<para > <command > screen</command> needs two directories created at boot with specific modes and ownership.</para>
2012-01-17 21:04:12 +07:00
<programlisting > d /var/run/screens 1777 root root 10d
2010-11-11 05:01:20 +07:00
d /var/run/uscreens 0755 root root 10d12h</programlisting>
2010-11-05 03:31:07 +07:00
</example>
</refsect1>
<refsect1 >
<title > See Also</title>
<para >
2011-02-13 21:08:15 +07:00
<citerefentry > <refentrytitle > systemd</refentrytitle> <manvolnum > 1</manvolnum> </citerefentry> ,
2012-06-27 21:30:57 +07:00
<citerefentry > <refentrytitle > systemd-tmpfiles</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> ,
<citerefentry > <refentrytitle > systemd-delta</refentrytitle> <manvolnum > 1</manvolnum> </citerefentry>
2010-11-05 03:31:07 +07:00
</para>
</refsect1>
</refentry>
