diff --git a/man/resolved.conf.xml b/man/resolved.conf.xml index 3c56b76748..2b9f482971 100644 --- a/man/resolved.conf.xml +++ b/man/resolved.conf.xml @@ -75,7 +75,7 @@ Domains= - A space-separated list of domains optionally prefixed with ~, + A space-separated list of domains, optionally prefixed with ~, used for two distinct purposes described below. Defaults to the empty list. Any domains not prefixed with ~ are used as search @@ -86,17 +86,23 @@ /etc/resolv.conf with the search keyword are used instead, if that file exists and any domains are configured in it. - The domains prefixed with ~ are called "routing domains". All domains listed - here (both search domains and routing domains after removing the ~ prefix) define - a search path that preferably directs DNS queries to this interface. This search path has an effect - only when suitable per-link DNS servers are known. Such servers may be defined through the - DNS= setting (see above) and dynamically at run time, for example from DHCP - leases. If no per-link DNS servers are known, routing domains have no effect. + The domains prefixed with ~ are called "route-only domains". All domains + listed here (both search domains and route-only domains after removing the + ~ prefix) define a search path that preferably directs DNS queries to this + interface. This search path has an effect only when suitable per-link DNS servers are known. Such + servers may be defined through the DNS= setting (see above) and dynamically at run + time, for example from DHCP leases. If no per-link DNS servers are known, route-only domains have no + effect. Use the construct ~. (which is composed from ~ to - indicate a routing domain and . to indicate the DNS root domain that is the + indicate a route-only domain and . to indicate the DNS root domain that is the implied suffix of all DNS domains) to use the DNS servers defined for this link preferably for all - domains. + domains. + + See "Protocols and Routing" in + systemd-resolved.service8 + for details of how search and route-only domains are used. +