[systemd-commits] 2 commits - .gitignore man/sysctl.d.xml man/systemd-tmpfiles.xml man/tmpfiles.d.xml units/.gitignore
Kay Sievers
kay at kemper.freedesktop.org
Sun Jun 10 09:30:40 PDT 2012
.gitignore | 1 +
man/sysctl.d.xml | 2 +-
man/systemd-tmpfiles.xml | 17 ++++++++---------
man/tmpfiles.d.xml | 36 +++++++++++++++++++++---------------
units/.gitignore | 2 +-
5 files changed, 32 insertions(+), 26 deletions(-)
New commits:
commit eb125fb69376d86785066e1f42d0d231ad7dd9ff
Author: Kay Sievers <kay at vrfy.org>
Date: Sun Jun 10 18:28:53 2012 +0200
update .gitignore
diff --git a/.gitignore b/.gitignore
index e97b1c7..abb7255 100644
--- a/.gitignore
+++ b/.gitignore
@@ -123,3 +123,4 @@ stamp-*
/v4l_id
/test-libudev
/test-udev
+/systemd-readahead-analyze
diff --git a/units/.gitignore b/units/.gitignore
index 626b12a..bcbff33 100644
--- a/units/.gitignore
+++ b/units/.gitignore
@@ -46,4 +46,4 @@ emergency.service
/systemd-udev-settle.service
/systemd-udev-trigger.service
/systemd-udev.service
-/units/systemd-debug-shell.service
+/systemd-debug-shell.service
commit 6110885c2c4b7c576ac5819af5416ec54200d8e3
Author: Kay Sievers <kay at vrfy.org>
Date: Sun Jun 10 18:26:11 2012 +0200
man: systemd-tmpfiles - document proper config-file-stack order
diff --git a/man/sysctl.d.xml b/man/sysctl.d.xml
index a4a495e..048d23f 100644
--- a/man/sysctl.d.xml
+++ b/man/sysctl.d.xml
@@ -81,7 +81,7 @@
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
+ <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
diff --git a/man/systemd-tmpfiles.xml b/man/systemd-tmpfiles.xml
index f58913d..4ac7224 100644
--- a/man/systemd-tmpfiles.xml
+++ b/man/systemd-tmpfiles.xml
@@ -59,14 +59,14 @@
<para><command>systemd-tmpfiles</command> creates,
deletes and cleans up volatile and temporary files and
- directories, based on the configuration from
- <filename>/etc/tmpfiles.d/</filename>. See
- <citerefentry><refentrytitle>tmpfiles.d</refentrytitle><manvolnum>5</manvolnum></citerefentry>
- for more details on these files.</para>
-
- <para>If invoked with no arguments applies all
- directives from all configuration files in
- <filename>/etc/tmpfiles.d/*.conf</filename>. If one or
+ directories, based on the configuration file format and
+ location specified in <citerefentry>
+ <refentrytitle>tmpfiles.d</refentrytitle>
+ <manvolnum>5</manvolnum>
+ </citerefentry>.</para>
+
+ <para>If invoked with no arguments, it applies all
+ directives from all configuration files. If one or
more absolute file names are passed on the command
line only the directives in these files are
applied.</para>
@@ -145,7 +145,6 @@
<para>
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>tmpfiles.d</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
- <citerefentry><refentrytitle>tmpwatch</refentrytitle><manvolnum>8</manvolnum></citerefentry>
</para>
</refsect1>
diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml
index 5d4b2ac..8987c48 100644
--- a/man/tmpfiles.d.xml
+++ b/man/tmpfiles.d.xml
@@ -66,24 +66,30 @@
<refsect1>
<title>Configuration Format</title>
- <para>Each configuration file is 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>. Files in
- <filename>/run</filename> override files with the same
- name in <filename>/etc/</filename> and
- <filename>/usr/lib/</filename>. Packages should
- install their configuration files in
- <filename>/usr/lib/</filename>, files in
+ <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
<filename>/etc/</filename> are reserved for the local
- administrator, who may choose to override the
- configurations installed from packages. The list of
+ administrator, who may use this logic to override the
+ configuration files installed by vendor packages. All
configuration files are sorted by their filename in
alphabetical order, regardless in which of the
- directories they reside, to guarantee that a
- configuration file takes precedence over another
- configuration file with an alphabetically later
- name.</para>
+ 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>
<para>The configuration format is one line per path
containing action, path, mode, ownership, age and argument
More information about the systemd-commits
mailing list