diff --git a/factory/etc/nsswitch.conf b/factory/etc/nsswitch.conf index da74b19d90..d87f8811ec 100644 --- a/factory/etc/nsswitch.conf +++ b/factory/etc/nsswitch.conf @@ -4,7 +4,7 @@ passwd: compat systemd group: compat [SUCCESS=merge] systemd shadow: compat -hosts: files mymachines resolve [!UNAVAIL=return] dns myhostname +hosts: mymachines resolve [!UNAVAIL=return] files myhostname dns networks: files protocols: db files diff --git a/man/nss-myhostname.xml b/man/nss-myhostname.xml index a41c383bb3..b424f1fbd2 100644 --- a/man/nss-myhostname.xml +++ b/man/nss-myhostname.xml @@ -67,12 +67,12 @@ hosts: in /etc/nsswitch.conf. 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. + and "traditional" modules like 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,11 +83,11 @@ passwd: compat systemd -group: compat systemd +group: compat [SUCCESS=merge] systemd shadow: compat -# Either (untrusted network): -hosts: mymachines resolve [!UNAVAIL=return] myhostname files dns +# Either (untrusted network, see above): +hosts: mymachines resolve [!UNAVAIL=return] files myhostname dns # Or (only trusted networks): hosts: mymachines resolve [!UNAVAIL=return] files dns myhostname networks: files diff --git a/man/nss-mymachines.xml b/man/nss-mymachines.xml index e0e6989c40..56ee073c8a 100644 --- a/man/nss-mymachines.xml +++ b/man/nss-mymachines.xml @@ -42,10 +42,10 @@ To activate the NSS module, add mymachines to the line starting with hosts: in /etc/nsswitch.conf. - It is recommended to place mymachines after the files or - compat entry of the /etc/nsswitch.conf line to make sure that its - mappings are preferred over other resolvers such as DNS, but so that /etc/hosts - based mappings take precedence. + It is recommended to place mymachines before the resolve or + dns entry of the hosts: line of + /etc/nsswitch.conf in order to make sure that its mappings are preferred over other + resolvers such as DNS. @@ -56,10 +56,10 @@ passwd: compat systemd -group: compat systemd +group: compat [SUCCESS=merge] systemd shadow: compat -hosts: mymachines resolve [!UNAVAIL=return] myhostname files dns +hosts: mymachines resolve [!UNAVAIL=return] files myhostname dns networks: files protocols: db files diff --git a/man/nss-resolve.xml b/man/nss-resolve.xml index c377468953..e6963e5812 100644 --- a/man/nss-resolve.xml +++ b/man/nss-resolve.xml @@ -44,14 +44,12 @@ 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 - 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 + Note that systemd-resolved will synthesize DNS resource records in a few cases, + for example for localhost and the current local 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. @@ -64,10 +62,10 @@ passwd: compat systemd -group: compat systemd +group: compat [SUCCESS=merge] systemd shadow: compat -hosts: mymachines resolve [!UNAVAIL=return] myhostname files dns +hosts: mymachines resolve [!UNAVAIL=return] files myhostname dns networks: files protocols: db files diff --git a/man/nss-systemd.xml b/man/nss-systemd.xml index 34aee0e880..6285b8da9d 100644 --- a/man/nss-systemd.xml +++ b/man/nss-systemd.xml @@ -65,7 +65,7 @@ group: compat [SUCCESS=merge] systemd shadow: compat -hosts: mymachines resolve [!UNAVAIL=return] myhostname files dns +hosts: mymachines resolve [!UNAVAIL=return] files myhostname dns networks: files protocols: db files