diff --git a/man/nss-myhostname.xml b/man/nss-myhostname.xml
index 908c91eb7c..e23b24483e 100644
--- a/man/nss-myhostname.xml
+++ b/man/nss-myhostname.xml
@@ -67,9 +67,13 @@
To activate the NSS modules, add myhostname to the line starting with
hosts: in /etc/nsswitch.conf.
- It is recommended to place myhostname last in the nsswitch.conf'
- hosts: line to make sure that this mapping is only used as fallback, and that any DNS or
- /etc/hosts based mapping takes precedence.
+ It is recommended to place myhostname either between resolve
+ and "traditional" modules like files and dns, or after them. In the
+ first version, well-known names like localhost and the machine hostname are given
+ higher priority than the external configuration. This is recommended when the external DNS servers and
+ network are not absolutely trusted. In the second version, external configuration is given higher
+ priority and nss-myhostname only provides a fallback mechanism. This might be suitable
+ in closely controlled networks, for example on a company LAN.
@@ -83,7 +87,10 @@
group: compat mymachines systemd
shadow: compat
-hosts: files mymachines resolve [!UNAVAIL=return] dns myhostname
+# Either (untrusted network):
+hosts: mymachines resolve [!UNAVAIL=return] myhostname files dns
+# Or (only trusted networks):
+hosts: mymachines resolve [!UNAVAIL=return] files dns myhostname
networks: files
protocols: db files
diff --git a/man/nss-mymachines.xml b/man/nss-mymachines.xml
index 40b0abee34..1ff88aba2d 100644
--- a/man/nss-mymachines.xml
+++ b/man/nss-mymachines.xml
@@ -69,7 +69,7 @@
group: compat mymachines systemd
shadow: compat
-hosts: files mymachines resolve [!UNAVAIL=return] dns myhostname
+hosts: mymachines resolve [!UNAVAIL=return] myhostname files dns
networks: files
protocols: db files
diff --git a/man/nss-resolve.xml b/man/nss-resolve.xml
index e4ea4e1898..cc33b2c082 100644
--- a/man/nss-resolve.xml
+++ b/man/nss-resolve.xml
@@ -34,14 +34,15 @@
name resolution service. It replaces the nss-dns plug-in module that traditionally resolves
hostnames via DNS.
- To activate the NSS module, add resolve to the line starting with
- 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.
+ To activate the NSS module, add resolveĀ [!UNAVAIL=return] to the line starting
+ with hosts: in /etc/nsswitch.conf. Specifically, it is
+ recommended to place resolve early in /etc/nsswitch.conf's
+ hosts: line. It should be before the files entry, since
+ systemd-resolved supports /etc/hosts internally, but with
+ caching. To the contrary, it should be after mymachines, to give hostnames given to
+ local VMs and containers precedence over names received over DNS. Finally, we recommend placing
+ dns somewhere after resolve, to fall back to
+ nss-dns if systemd-resolved.service is not available.
Note that systemd-resolved will synthesize DNS resource
records in a few cases, for example for localhost and the
@@ -66,7 +67,7 @@
group: compat mymachines systemd
shadow: compat
-hosts: files mymachines resolve [!UNAVAIL=return] dns myhostname
+hosts: mymachines resolve [!UNAVAIL=return] myhostname files dns
networks: files
protocols: db files
diff --git a/man/nss-systemd.xml b/man/nss-systemd.xml
index e343c406f2..ac22452bc3 100644
--- a/man/nss-systemd.xml
+++ b/man/nss-systemd.xml
@@ -65,7 +65,7 @@
group: compat [SUCCESS=merge] mymachines [SUCCESS=merge] systemd
shadow: compat
-hosts: files mymachines resolve [!UNAVAIL=return] dns myhostname
+hosts: mymachines resolve [!UNAVAIL=return] myhostname files dns
networks: files
protocols: db files