hostname.7: HOSTALIASES/search path processing is DNS-specific

Other NSS modules do not necessarily honor these settings.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

diff --git a/man7/hostname.7 b/man7/hostname.7
index 4c07485c7a718d561d7d854e29302b24db5b554d..f8a337c390f60968284c4e8789d4da4b2f9f9101 100644 (file)
--- a/man7/hostname.7
+++ b/man7/hostname.7
@@ -65,8 +65,16 @@ which must generally translate the name to an address for use.
 .BR getaddrinfo (3)
 or the obsolete
 .BR gethostbyname (3).)
-Hostnames are resolved by the Internet name resolver in the following
-fashion.
+.PP
+Hostnames are resolved by the NSS framework in glibc according
+to the
+.B hosts
+configuration in
+.BR nsswitch.conf .
+The DNS-based name resolver
+(in the
+.B dns
+NSS service module) resolves them in the following fashion.
 .PP
 If the name consists of a single component, that is, contains no dot,
 and if the environment variable
@@ -100,6 +108,7 @@ by a system-wide configuration file (see
 .SH SEE ALSO
 .BR getaddrinfo (3),
 .BR gethostbyname (3),
+.BR nsswitch.conf (5),
 .BR resolver (5),
 .BR mailaddr (7),
 .BR named (8)