mirror of
https://github.com/systemd/systemd
synced 2024-09-06 16:56:43 +00:00
Merge pull request #28919 from fbuihuu/custom-config-file-install-path
Custom config file install path
This commit is contained in:
commit
6d2d38e76f
|
@ -42,11 +42,12 @@
|
||||||
<title>Configuration Directories and Precedence</title>
|
<title>Configuration Directories and Precedence</title>
|
||||||
|
|
||||||
<para>The default configuration is set during compilation, so configuration is only needed when it is
|
<para>The default configuration is set during compilation, so configuration is only needed when it is
|
||||||
necessary to deviate from those defaults. Initially, the main configuration file in
|
necessary to deviate from those defaults. The main configuration file is either in
|
||||||
<filename>/etc/systemd/</filename> contains commented out entries showing the defaults as a guide to the
|
<filename>/usr/lib/systemd</filename> or <filename>/etc/systemd/</filename> and contains commented out
|
||||||
administrator. Local overrides can be created by editing this file or by creating drop-ins, as described
|
entries showing the defaults as a guide to the administrator. Local overrides can be created by creating
|
||||||
below. Using drop-ins for local configuration is recommended over modifications to the main configuration
|
drop-ins, as described below. The main configuration file can also be edited for this purpose (or a copy
|
||||||
file.</para>
|
in <filename>/etc</filename> if it's shipped in <filename>/usr</filename>) however using drop-ins for
|
||||||
|
local configuration is recommended over modifications to the main configuration file.</para>
|
||||||
|
|
||||||
<para>In addition to the "main" configuration file, drop-in configuration snippets are read from
|
<para>In addition to the "main" configuration file, drop-in configuration snippets are read from
|
||||||
<filename>/usr/lib/systemd/*.conf.d/</filename>, <filename>/usr/local/lib/systemd/*.conf.d/</filename>,
|
<filename>/usr/lib/systemd/*.conf.d/</filename>, <filename>/usr/local/lib/systemd/*.conf.d/</filename>,
|
||||||
|
@ -62,7 +63,9 @@
|
||||||
who may use this logic to override the configuration files installed by vendor packages. Drop-ins have to
|
who may use this logic to override the configuration files installed by vendor packages. Drop-ins have to
|
||||||
be used to override package drop-ins, since the main configuration file has lower precedence. It is
|
be used to override package drop-ins, since the main configuration file has lower precedence. It is
|
||||||
recommended to prefix all filenames in those subdirectories with a two-digit number and a dash, to
|
recommended to prefix all filenames in those subdirectories with a two-digit number and a dash, to
|
||||||
simplify the ordering of the files.</para>
|
simplify the ordering of the files. This also defined a concept of drop-in priority to allow
|
||||||
|
distributions to ship drop-ins within a specific range lower than the range used by users. This should
|
||||||
|
lower the risk of package drop-ins overriding accidentally drop-ins defined by users.</para>
|
||||||
|
|
||||||
<para>To disable a configuration file supplied by the vendor, the recommended way is to place a symlink
|
<para>To disable a configuration file supplied by the vendor, the recommended way is to place a symlink
|
||||||
to <filename>/dev/null</filename> in the configuration directory in <filename>/etc/</filename>, with the
|
to <filename>/dev/null</filename> in the configuration directory in <filename>/etc/</filename>, with the
|
||||||
|
|
|
@ -6,9 +6,11 @@
|
||||||
# any later version.
|
# any later version.
|
||||||
#
|
#
|
||||||
# Entries in this file show the compile time defaults. Local configuration
|
# Entries in this file show the compile time defaults. Local configuration
|
||||||
# should be created by either modifying this file, or by creating "drop-ins" in
|
# should be created by either modifying this file (or a copy of it placed in
|
||||||
# the system.conf.d/ subdirectory. The latter is generally recommended.
|
# /etc if the original file is shipped in /usr), or by creating "drop-ins" in
|
||||||
# Defaults can be restored by simply deleting this file and all drop-ins.
|
# /etc/systemd/system.conf.d/ directory. The latter is generally recommended.
|
||||||
|
# Defaults can be restored by simply deleting the main configuration file and
|
||||||
|
# all drop-ins located in /etc.
|
||||||
#
|
#
|
||||||
# Use 'systemd-analyze cat-config systemd/system.conf' to display the full config.
|
# Use 'systemd-analyze cat-config systemd/system.conf' to display the full config.
|
||||||
#
|
#
|
||||||
|
|
|
@ -10,6 +10,8 @@
|
||||||
# the journal-remote.conf.d/ subdirectory. The latter is generally recommended.
|
# the journal-remote.conf.d/ subdirectory. The latter is generally recommended.
|
||||||
# Defaults can be restored by simply deleting this file and all drop-ins.
|
# Defaults can be restored by simply deleting this file and all drop-ins.
|
||||||
#
|
#
|
||||||
|
# Use 'systemd-analyze cat-config systemd/journal-remote.conf' to display the full config.
|
||||||
|
#
|
||||||
# See journal-remote.conf(5) for details.
|
# See journal-remote.conf(5) for details.
|
||||||
|
|
||||||
[Remote]
|
[Remote]
|
||||||
|
|
|
@ -10,6 +10,8 @@
|
||||||
# the journal-upload.conf.d/ subdirectory. The latter is generally recommended.
|
# the journal-upload.conf.d/ subdirectory. The latter is generally recommended.
|
||||||
# Defaults can be restored by simply deleting this file and all drop-ins.
|
# Defaults can be restored by simply deleting this file and all drop-ins.
|
||||||
#
|
#
|
||||||
|
# Use 'systemd-analyze cat-config systemd/journal-upload.conf' to display the full config.
|
||||||
|
#
|
||||||
# See journal-upload.conf(5) for details.
|
# See journal-upload.conf(5) for details.
|
||||||
|
|
||||||
[Upload]
|
[Upload]
|
||||||
|
|
|
@ -10,6 +10,8 @@
|
||||||
# the networkd.conf.d/ subdirectory. The latter is generally recommended.
|
# the networkd.conf.d/ subdirectory. The latter is generally recommended.
|
||||||
# Defaults can be restored by simply deleting this file and all drop-ins.
|
# Defaults can be restored by simply deleting this file and all drop-ins.
|
||||||
#
|
#
|
||||||
|
# Use 'systemd-analyze cat-config systemd/networkd.conf' to display the full config.
|
||||||
|
#
|
||||||
# See networkd.conf(5) for details.
|
# See networkd.conf(5) for details.
|
||||||
|
|
||||||
[Network]
|
[Network]
|
||||||
|
|
|
@ -10,6 +10,8 @@
|
||||||
# the pstore.conf.d/ subdirectory. The latter is generally recommended.
|
# the pstore.conf.d/ subdirectory. The latter is generally recommended.
|
||||||
# Defaults can be restored by simply deleting this file and all drop-ins.
|
# Defaults can be restored by simply deleting this file and all drop-ins.
|
||||||
#
|
#
|
||||||
|
# Use 'systemd-analyze cat-config systemd/pstore.conf' to display the full config.
|
||||||
|
#
|
||||||
# See pstore.conf(5) for details.
|
# See pstore.conf(5) for details.
|
||||||
|
|
||||||
[PStore]
|
[PStore]
|
||||||
|
|
|
@ -10,6 +10,8 @@
|
||||||
# the sleep.conf.d/ subdirectory. The latter is generally recommended.
|
# the sleep.conf.d/ subdirectory. The latter is generally recommended.
|
||||||
# Defaults can be restored by simply deleting this file and all drop-ins.
|
# Defaults can be restored by simply deleting this file and all drop-ins.
|
||||||
#
|
#
|
||||||
|
# Use 'systemd-analyze cat-config systemd/sleep.conf' to display the full config.
|
||||||
|
#
|
||||||
# See systemd-sleep.conf(5) for details.
|
# See systemd-sleep.conf(5) for details.
|
||||||
|
|
||||||
[Sleep]
|
[Sleep]
|
||||||
|
|
|
@ -10,6 +10,8 @@
|
||||||
# the timesyncd.conf.d/ subdirectory. The latter is generally recommended.
|
# the timesyncd.conf.d/ subdirectory. The latter is generally recommended.
|
||||||
# Defaults can be restored by simply deleting this file and all drop-ins.
|
# Defaults can be restored by simply deleting this file and all drop-ins.
|
||||||
#
|
#
|
||||||
|
# Use 'systemd-analyze cat-config systemd/timesyncd.conf' to display the full config.
|
||||||
|
#
|
||||||
# See timesyncd.conf(5) for details.
|
# See timesyncd.conf(5) for details.
|
||||||
|
|
||||||
[Time]
|
[Time]
|
||||||
|
|
Loading…
Reference in a new issue