diff --git a/man/nss-resolve.xml b/man/nss-resolve.xml index 4e102cec262..51b228f104f 100644 --- a/man/nss-resolve.xml +++ b/man/nss-resolve.xml @@ -63,13 +63,24 @@ hostnames via DNS. To activate the NSS module, add resolve to the line starting with - hosts: in /etc/nsswitch.conf. Specifcally, it is recommended to place - resolve early in /etc/nsswitch.conf' hosts: line (but + hosts: in /etc/nsswitch.conf. Specifically, it is recommended to place + resolve early in /etc/nsswitch.conf's hosts: line (but after the files or mymachines entries), right before the dns entry if it exists, followed by [!UNAVAIL=return], to ensure DNS queries are always routed via systemd-resolved8 if it is running, but are routed to nss-dns if this service is not available. + + Note that systemd-resolved will synthesize DNS resource + records in a few cases, for example for the localhost and the + current hostname, see + systemd-resolved8 + for the full list. This duplicates the functionality of + nss-myhostname8, + but it is still recommended (see examples below) to keep + nss-myhostname configured in + /etc/nsswitch.conf, to keep those names resolveable if + systemd-resolved is not running.