[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>&lt;program&gt;.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>&lt;program&gt;.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