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:
@@ -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>
|
||||
|
||||
Reference in New Issue
Block a user