|
11 | 11 | <refsection id='confd'> |
12 | 12 | <title>Configuration Directories and Precedence</title> |
13 | 13 |
|
14 | | - <para>Configuration files are read from directories in |
15 | | - <filename>/etc/</filename>, <filename>/run/</filename>, and |
16 | | - <filename>/usr/lib/</filename>, in order of precedence. |
17 | | - Each configuration file in these configuration directories shall be named in |
18 | | - the style of <filename><replaceable>filename</replaceable>.conf</filename>. |
19 | | - Files in <filename>/etc/</filename> override files with the same name in |
20 | | - <filename>/run/</filename> and <filename>/usr/lib/</filename>. Files in |
21 | | - <filename>/run/</filename> override files with the same name in |
22 | | - <filename>/usr/lib/</filename>.</para> |
| 14 | + <para>Configuration files are read from directories in <filename>/etc/</filename>, <filename>/run/</filename>, |
| 15 | + <filename>/usr/local/lib/</filename>, and <filename>/usr/lib/</filename>, in order of precedence. Each |
| 16 | + configuration file in these configuration directories shall be named in the style of |
| 17 | + <filename><replaceable>filename</replaceable>.conf</filename>. Files in <filename>/etc/</filename> override files |
| 18 | + with the same name in <filename>/run/</filename>, <filename>/usr/local/lib/</filename>, and |
| 19 | + <filename>/usr/lib/</filename>. Files in <filename>/run/</filename> override files with the same name under |
| 20 | + <filename>/usr/</filename>.</para> |
23 | 21 |
|
24 | | - <para>Packages should install their configuration files in |
25 | | - <filename>/usr/lib/</filename>. Files in <filename>/etc/</filename> are |
| 22 | + <para>Packages should install their configuration files in <filename>/usr/lib/</filename> (distribution packages) |
| 23 | + or <filename>/usr/local/lib/</filename> (local installs). Files in <filename>/etc/</filename> are |
26 | 24 | reserved for the local administrator, who may use this logic to override the |
27 | 25 | configuration files installed by vendor packages. All configuration files |
28 | 26 | are sorted by their filename in lexicographic order, regardless of which of |
|
52 | 50 |
|
53 | 51 | <para>When packages need to customize the configuration, they can |
54 | 52 | install configuration snippets in |
55 | | - <filename>/usr/lib/systemd/*.conf.d/</filename>. Files in |
| 53 | + <filename>/usr/lib/systemd/*.conf.d/</filename> or |
| 54 | + <filename>/usr/local/lib/systemd/*.conf.d/</filename>. Files in |
56 | 55 | <filename>/etc/</filename> are reserved for the local |
57 | 56 | administrator, who may use this logic to override the |
58 | 57 | configuration files installed by vendor packages. The main |
|
0 commit comments