← Back to branch summary

~ubuntu-branches/debian/jessie/systemd/jessie

« back to all changes in this revision

Viewing changes to man/tmpfiles.d.xml

  • Committer: Package Import Robot
  • Author(s): Tollef Fog Heen, Tollef Fog Heen, Michael Biebl
  • Date: 2012-04-03 19:59:17 UTC
  • mfrom: (1.1.10) (6.1.3 experimental)
  • Revision ID: package-import@ubuntu.com-20120403195917-l532urrbg4pkreas
Tags: 44-1
http://bugs.debian.org/664364
http://bugs.debian.org/663219
http://bugs.debian.org/663323
[ Tollef Fog Heen ]
* New upstream version.
  - Backport 3492207: journal: PAGE_SIZE is not known on ppc and other
    archs
  - Backport 5a2a2a1: journal: react with immediate rotation to a couple
    of more errors
  - Backport 693ce21: util: never follow symlinks in rm_rf_children()
    Fixes CVE-2012-1174, closes: #664364
* Drop output message from init-functions hook, it's pointless.
* Only rmdir /lib/init/rw if it exists.
* Explicitly order debian-fixup before sysinit.target to prevent a
  possible race condition with the creation of sockets.  Thanks to
  Michael Biebl for debugging this.
* Always restart the initctl socket on upgrades, to mask sysvinit
  removing it.

[ Michael Biebl ]
* Remove workaround for non-interactive sessions from pam config again.
* Create compat /dev/initctl symlink in case we are upgrading from a system
  running a newer version of sysvinit (using /run/initctl) and sysvinit is
  replaced with systemd-sysv during the upgrade. Closes: #663219
* Install new man pages.
* Build-Depend on valac (>= 0.12) instead of valac-0.12. Closes: #663323

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/tmpfiles.d.xml
47
47
        </refnamediv>
48
48
 
49
49
        <refsynopsisdiv>
50
 
                <para><filename>/usr/lib/tmpfiles.d/*.conf</filename></para>
51
50
                <para><filename>/etc/tmpfiles.d/*.conf</filename></para>
52
51
                <para><filename>/run/tmpfiles.d/*.conf</filename></para>
 
52
                <para><filename>/usr/lib/tmpfiles.d/*.conf</filename></para>
53
53
        </refsynopsisdiv>
54
54
 
55
55
        <refsect1>
67
67
                <title>Configuration Format</title>
68
68
 
69
69
                <para>Each configuration file is named in the style of
70
 
                <filename>&lt;program&gt;.conf</filename>.
71
 
                Files in <filename>/etc/</filename> overwrite
72
 
                files with the same name in <filename>/usr/lib/</filename>.
73
 
                Files in <filename>/run</filename> overwrite files with
74
 
                the same name in <filename>/etc/</filename> and
75
 
                <filename>/usr/lib/</filename>. Packages should install their
76
 
                configuration files in <filename>/usr/lib/</filename>, files
77
 
                in <filename>/etc/</filename> are reserved for the local
78
 
                administration, which possibly decides to overwrite the
79
 
                configurations installed from packages. All files are sorted
80
 
                by filename in alphabetical order, regardless in which of the
81
 
                directories they reside, to ensure that a specific
82
 
                configuration file takes precedence over another file with
83
 
                an alphabetically later name.</para>
 
70
                <filename>&lt;program&gt;.conf</filename>.  Files in
 
71
                <filename>/etc/</filename> override files with the
 
72
                same name in <filename>/usr/lib/</filename>.  Files in
 
73
                <filename>/run</filename> override files with the same
 
74
                name in <filename>/etc/</filename> and
 
75
                <filename>/usr/lib/</filename>. Packages should
 
76
                install their configuration files in
 
77
                <filename>/usr/lib/</filename>, files in
 
78
                <filename>/etc/</filename> are reserved for the local
 
79
                administrator, who may choose to override the
 
80
                configurations installed from packages. The list of
 
81
                configuration files are sorted by their filename in
 
82
                alphabetical order, regardless in which of the
 
83
                directories they reside, to guarantee that a
 
84
                configuration file takes precedence over another
 
85
                configuration file with an alphabetically later
 
86
                name.</para>
84
87
 
85
88
                <para>The configuration format is one line per path
86
 
                containing action, mode, ownership and age
 
89
                containing action, path, mode, ownership, age and argument
87
90
                fields:</para>
88
91
 
89
 
                <programlisting>Type Path          Mode UID  GID  Age
90
 
d    /run/user 0755 root root 10d</programlisting>
 
92
                <programlisting>Type Path        Mode UID  GID  Age Argument
 
93
d    /run/user   0755 root root 10d -
 
94
L    /tmp/foobar -    -    -    -   /dev/null</programlisting>
91
95
 
92
96
                <refsect2>
93
97
                        <title>Type</title>
94
98
                        <variablelist>
95
99
                                <varlistentry>
96
100
                                        <term><varname>f</varname></term>
97
 
                                        <listitem><para>Create a file if it doesn't exist yet</para></listitem>
 
101
                                        <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>
98
102
                                </varlistentry>
99
103
 
100
104
                                <varlistentry>
101
105
                                        <term><varname>F</varname></term>
102
 
                                        <listitem><para>Create or truncate a file</para></listitem>
 
106
                                        <listitem><para>Create or truncate a file (optionally writing a short string into it, if the argument parameter is passed)</para></listitem>
 
107
                                </varlistentry>
 
108
 
 
109
                                <varlistentry>
 
110
                                        <term><varname>w</varname></term>
 
111
                                        <listitem><para>Write the argument parameter to a file, if it exists.</para></listitem>
103
112
                                </varlistentry>
104
113
 
105
114
                                <varlistentry>
118
127
                                </varlistentry>
119
128
 
120
129
                                <varlistentry>
 
130
                                        <term><varname>L</varname></term>
 
131
                                        <listitem><para>Create a symlink if it doesn't exist yet</para></listitem>
 
132
                                </varlistentry>
 
133
 
 
134
                                <varlistentry>
 
135
                                        <term><varname>c</varname></term>
 
136
                                        <listitem><para>Create a character device node if it doesn't exist yet</para></listitem>
 
137
                                </varlistentry>
 
138
 
 
139
                                <varlistentry>
 
140
                                        <term><varname>b</varname></term>
 
141
                                        <listitem><para>Create a block device node if it doesn't exist yet</para></listitem>
 
142
                                </varlistentry>
 
143
 
 
144
                                <varlistentry>
121
145
                                        <term><varname>x</varname></term>
122
146
                                        <listitem><para>Ignore a path
123
147
                                        during cleaning. Use this type
155
179
                                        place of normal path
156
180
                                        names.</para></listitem>
157
181
                                </varlistentry>
 
182
 
 
183
                                <varlistentry>
 
184
                                        <term><varname>z</varname></term>
 
185
                                        <listitem><para>Restore
 
186
                                        SELinux security context label
 
187
                                        and set ownership and access
 
188
                                        mode of a file or directory if
 
189
                                        it exists.  Lines of this type
 
190
                                        accept shell-style globs in
 
191
                                        place of normal path names.
 
192
                                        </para></listitem>
 
193
                                </varlistentry>
 
194
 
 
195
                                <varlistentry>
 
196
                                        <term><varname>Z</varname></term>
 
197
                                        <listitem><para>Recursively
 
198
                                        restore SELinux security
 
199
                                        context label and set
 
200
                                        ownership and access mode of a
 
201
                                        path and all its
 
202
                                        subdirectories (if it is a
 
203
                                        directory). Lines of this type
 
204
                                        accept shell-style globs in
 
205
                                        place of normal path
 
206
                                        names.</para></listitem>
 
207
                                </varlistentry>
158
208
                        </variablelist>
159
209
                </refsect2>
160
210
 
164
214
                        <para>The file access mode to use when
165
215
                        creating this file or directory. If omitted or
166
216
                        when set to - the default is used: 0755 for
167
 
                        directories, 0644 for files. This parameter is
168
 
                        ignored for x, r, R lines.</para>
 
217
                        directories, 0644 for all other file
 
218
                        objects. For z, Z lines if omitted or when set
 
219
                        to - the file access mode will not be
 
220
                        modified. This parameter is ignored for x, r,
 
221
                        R, L lines.</para>
169
222
                </refsect2>
170
223
 
171
224
                <refsect2>
175
228
                        or directory. This may either be a numeric
176
229
                        user/group ID or a user or group name. If
177
230
                        omitted or when set to - the default 0 (root)
178
 
                        is used. . These parameters are ignored for x,
179
 
                        r, R lines.</para>
 
231
                        is used. For z, Z lines when omitted or when set to -
 
232
                        the file ownership will not be modified.
 
233
                        These parameters are ignored for x, r, R, L lines.</para>
180
234
                </refsect2>
181
235
 
182
236
                <refsect2>
209
263
                        is done.</para>
210
264
                </refsect2>
211
265
 
 
266
                <refsect2>
 
267
                        <title>Argument</title>
 
268
 
 
269
                        <para>For L lines determines the destination
 
270
                        path of the symlink. For c, b determines the
 
271
                        major/minor of the device node, with major and
 
272
                        minor formatted as integers, separated by :,
 
273
                        e.g. "1:3". For f, F, w may be used to specify
 
274
                        a short string that is written to the file,
 
275
                        suffixed by a newline. Ignored for all other
 
276
                        lines.</para>
 
277
                </refsect2>
 
278
 
212
279
        </refsect1>
213
280
 
214
281
        <refsect1>
217
284
                        <title>/etc/tmpfiles.d/screen.conf example</title>
218
285
                        <para><command>screen</command> needs two directories created at boot with specific modes and ownership.</para>
219
286
 
220
 
                        <programlisting>d /var/run/screens 1777 root root 10d
 
287
                        <programlisting>d /var/run/screens  1777 root root 10d
221
288
d /var/run/uscreens 0755 root root 10d12h</programlisting>
222
289
                </example>
223
290
        </refsect1>