]> git.ipfire.org Git - thirdparty/systemd.git/commitdiff
man: mention that drop-in files are merged in alphanumeric order
authorYu Watanabe <watanabe.yu+github@gmail.com>
Thu, 20 May 2021 06:55:06 +0000 (15:55 +0900)
committerLennart Poettering <lennart@poettering.net>
Thu, 20 May 2021 19:20:51 +0000 (21:20 +0200)
This addresses the request in https://github.com/systemd/systemd/issues/19467#issuecomment-829332877.

man/systemd.link.xml
man/systemd.netdev.xml
man/systemd.network.xml
man/systemd.unit.xml

index 34b56df937a47b22d0e387db822059bae9849eba..4650b8f852dbd7548dc0aab95173b2561273ac20 100644 (file)
@@ -47,9 +47,9 @@
 
     <para>Along with the link file <filename>foo.link</filename>, a "drop-in" directory
     <filename>foo.link.d/</filename> may exist. All files with the suffix <literal>.conf</literal>
-    from this directory will be parsed after the file itself is parsed. This is useful to alter or add
-    configuration settings, without having to modify the main configuration file. Each drop-in file
-    must have appropriate section headers.</para>
+    from this directory will be merged in the alphanumeric order and parsed after the main file itself
+    has been parsed. This is useful to alter or add configuration settings, without having to modify
+    the main configuration file. Each drop-in file must have appropriate section headers.</para>
 
     <para>In addition to <filename>/etc/systemd/network</filename>, drop-in <literal>.d</literal>
     directories can be placed in <filename>/usr/lib/systemd/network</filename> or
index d93ee8bb30cc4761a7098ff73c4b8f020fb49045..11442f2b828b72f994d4af0f44fc727d25545c55 100644 (file)
@@ -52,9 +52,9 @@
 
     <para>Along with the netdev file <filename>foo.netdev</filename>, a "drop-in" directory
     <filename>foo.netdev.d/</filename> may exist. All files with the suffix <literal>.conf</literal>
-    from this directory will be parsed after the file itself is parsed. This is useful to alter or
-    add configuration settings, without having to modify the main configuration file. Each drop-in
-    file must have appropriate section headers.</para>
+    from this directory will be merged in the alphanumeric order and parsed after the main file itself
+    has been parsed. This is useful to alter or add configuration settings, without having to modify
+    the main configuration file. Each drop-in file must have appropriate section headers.</para>
 
     <para>In addition to <filename>/etc/systemd/network</filename>, drop-in <literal>.d</literal>
     directories can be placed in <filename>/usr/lib/systemd/network</filename> or
index 64bd036e0c89b787edc3c068c98478712cfe2e11..beddcbe61704c4c75e552782b25df66ae52d5a94 100644 (file)
 
     <para>Along with the network file <filename>foo.network</filename>, a "drop-in" directory
     <filename>foo.network.d/</filename> may exist. All files with the suffix
-    <literal>.conf</literal> from this directory will be parsed after the file itself is
-    parsed. This is useful to alter or add configuration settings, without having to modify the main
-    configuration file. Each drop-in file must have appropriate section headers.</para>
+    <literal>.conf</literal> from this directory will be merged in the alphanumeric order and parsed
+    after the main file itself has been parsed. This is useful to alter or add configuration settings,
+    without having to modify the main configuration file. Each drop-in file must have appropriate
+    section headers.</para>
 
     <para>In addition to <filename>/etc/systemd/network</filename>, drop-in <literal>.d</literal>
     directories can be placed in <filename>/usr/lib/systemd/network</filename> or
index b7a5ec0362e2229a1ec09081da162f71fa6d9375..913cad05b4f4b2e8def0585994dd7e21470cfa1d 100644 (file)
     <citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
 
     <para>Along with a unit file <filename>foo.service</filename>, a "drop-in" directory
-    <filename>foo.service.d/</filename> may exist. All files with the suffix <literal>.conf</literal> from this
-    directory will be parsed after the unit file itself is parsed. This is useful to alter or add configuration
-    settings for a unit, without having to modify unit files. Drop-in files must contain appropriate section
-    headers. For instantiated units, this logic will first look for the instance <literal>.d/</literal> subdirectory
-    (e.g. <literal>foo@bar.service.d/</literal>) and read its <literal>.conf</literal> files, followed by the template
-    <literal>.d/</literal> subdirectory (e.g. <literal>foo@.service.d/</literal>) and the <literal>.conf</literal>
-    files there. Moreover for unit names containing dashes (<literal>-</literal>), the set of directories generated by
-    repeatedly truncating the unit name after all dashes is searched too. Specifically, for a unit name
+    <filename>foo.service.d/</filename> may exist. All files with the suffix
+    <literal>.conf</literal> from this directory will be merged in the alphanumeric order and parsed
+    after the main unit file itself has been parsed. This is useful to alter or add configuration
+    settings for a unit, without having to modify unit files. Each drop-in file must contain appropriate
+    section headers. For instantiated units, this logic will first look for the instance
+    <literal>.d/</literal> subdirectory (e.g. <literal>foo@bar.service.d/</literal>) and read its
+    <literal>.conf</literal> files, followed by the template <literal>.d/</literal> subdirectory (e.g.
+    <literal>foo@.service.d/</literal>) and the <literal>.conf</literal> files there. Moreover for unit
+    names containing dashes (<literal>-</literal>), the set of directories generated by repeatedly
+    truncating the unit name after all dashes is searched too. Specifically, for a unit name
     <filename>foo-bar-baz.service</filename> not only the regular drop-in directory
     <filename>foo-bar-baz.service.d/</filename> is searched but also both <filename>foo-bar-.service.d/</filename> and
     <filename>foo-.service.d/</filename>. This is useful for defining common drop-ins for a set of related units, whose