network: document that Domains= may be specified more than once (#43194)

The `Domains=` option in the `[Network]` section did not document its
behaviour when specified repeatedly. In practice the option is additive
(each occurrence accumulates search/routing domains) and assigning an
empty string resets the list, matching the closely related `DNS=`
option. This is implemented by `config_parse_domains()` in
`src/network/networkd-dns.c`, which frees both the search and route
domain sets on an empty `rvalue` and otherwise inserts each
whitespace-separated entry into the corresponding set.

Document this explicitly, using the same wording already used for
`DNS=` in the same man page, so users know repeated assignments are
combined and that an empty value clears them.

Fixes #38740.
This commit is contained in:
lzwind
2026-07-28 21:35:25 +09:00
committed by GitHub
parent c99678eeda
commit 9b76949a47
+3
View File
@@ -838,6 +838,9 @@ DuplicateAddressDetection=none</programlisting></para>
Domain name routing has no equivalent in the traditional glibc API, which has no concept of
domain name servers limited to a specific link.</para>
<para>This option may be specified more than once. If an empty string is assigned,
then the all previous assignments are cleared.</para>
<xi:include href="version-info.xml" xpointer="v216"/>
</listitem>
</varlistentry>