summaryrefslogtreecommitdiff
path: root/man/standard-conf.xml
diff options
context:
space:
mode:
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2019-01-02 13:53:49 +0100
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2019-02-18 10:25:25 +0100
commit5ae4336abc14d43c0917e25a362aff6cb76c0141 (patch)
tree384cb02b31055fb825e69867f4ae4796ed25e985 /man/standard-conf.xml
parent514fbdd78b4519f97ee07851b35ebd8c46081a3f (diff)
downloadsystemd-5ae4336abc14d43c0917e25a362aff6cb76c0141.tar.gz
man: document paths under /usr/local in standard-conf.xml
standard-conf.xml is currently included by: man/binfmt.d.xml man/environment.d.xml man/modules-load.d.xml man/sysctl.d.xml man/coredump.conf.xml man/journal-remote.conf.xml man/journal-upload.conf.xml man/journald.conf.xml man/logind.conf.xml man/networkd.conf.xml man/resolved.conf.xml man/systemd-sleep.conf.xml man/systemd-system.conf.xml All those programs actually use CONF_PATHS_NULSTR or CONF_PATHS_STRV, so this changes the documentation to match code.
Diffstat (limited to 'man/standard-conf.xml')
-rw-r--r--man/standard-conf.xml23
1 files changed, 11 insertions, 12 deletions
diff --git a/man/standard-conf.xml b/man/standard-conf.xml
index f5c961a0c2..1db859ac2f 100644
--- a/man/standard-conf.xml
+++ b/man/standard-conf.xml
@@ -11,18 +11,16 @@
<refsection id='confd'>
<title>Configuration Directories and Precedence</title>
- <para>Configuration files are read from directories in
- <filename>/etc/</filename>, <filename>/run/</filename>, and
- <filename>/usr/lib/</filename>, in order of precedence.
- Each configuration file in these configuration directories shall be named in
- the style of <filename><replaceable>filename</replaceable>.conf</filename>.
- Files in <filename>/etc/</filename> override files with the same name in
- <filename>/run/</filename> and <filename>/usr/lib/</filename>. Files in
- <filename>/run/</filename> override files with the same name in
- <filename>/usr/lib/</filename>.</para>
+ <para>Configuration files are read from directories in <filename>/etc/</filename>, <filename>/run/</filename>,
+ <filename>/usr/local/lib/</filename>, and <filename>/usr/lib/</filename>, in order of precedence. Each
+ configuration file in these configuration directories shall be named in the style of
+ <filename><replaceable>filename</replaceable>.conf</filename>. Files in <filename>/etc/</filename> override files
+ with the same name in <filename>/run/</filename>, <filename>/usr/local/lib/</filename>, and
+ <filename>/usr/lib/</filename>. Files in <filename>/run/</filename> override files with the same name under
+ <filename>/usr/</filename>.</para>
- <para>Packages should install their configuration files in
- <filename>/usr/lib/</filename>. Files in <filename>/etc/</filename> are
+ <para>Packages should install their configuration files in <filename>/usr/lib/</filename> (distribution packages)
+ or <filename>/usr/local/lib/</filename> (local installs). Files in <filename>/etc/</filename> are
reserved for the local administrator, who may use this logic to override the
configuration files installed by vendor packages. All configuration files
are sorted by their filename in lexicographic order, regardless of which of
@@ -52,7 +50,8 @@
<para>When packages need to customize the configuration, they can
install configuration snippets in
- <filename>/usr/lib/systemd/*.conf.d/</filename>. Files in
+ <filename>/usr/lib/systemd/*.conf.d/</filename> or
+ <filename>/usr/local/lib/systemd/*.conf.d/</filename>. Files in
<filename>/etc/</filename> are reserved for the local
administrator, who may use this logic to override the
configuration files installed by vendor packages. The main