On 09/01/2013 03:43 AM, Thomas Hood wrote: > In Debian 7 the host.conf(5) man page still describes the "order" > option which has been inoperative for years and still refers to > resolv+(8) which doesn't exist. And it still fails to mention > nsswitch.conf.
I've queued a fix for this upstream. Cheers, Michael -------- Original Message -------- Subject: Re: [PATCH] host.conf(5): order option deprecated, replaced by nsswitch.conf(5) Date: Sat, 17 May 2014 17:15:22 +0200 From: Michael Kerrisk (man-pages) <mtk.manpa...@gmail.com> To: Simon Paillard <spaill...@debian.org>, linux-...@vger.kernel.org CC: mtk.manpa...@gmail.com On 12/09/2012 06:13 PM, Simon Paillard wrote: > http://www.sourceware.org/bugzilla/show_bug.cgi?id=2389 > http://repo.or.cz/w/glibc.git/commit/b9c65d0902e5890c4f025b574725154032f8120a > > Reported at http://bugs.debian.org/270368 http://bugs.debian.org/396633 [...] Simon, I propose the patch below. Look okay to you? Cheers, Michael diff --git a/man3/resolver.3 b/man3/resolver.3 index a3fd2e8..7dc2002 100644 --- a/man3/resolver.3 +++ b/man3/resolver.3 @@ -29,7 +29,7 @@ .\" Modified 1993-07-25 by Rik Faith (fa...@cs.unc.edu) .\" Modified 2004-10-31 by aeb .\" -.TH RESOLVER 3 2013-03-05 "GNU" "Linux Programmer's Manual" +.TH RESOLVER 3 2014-05-17 "GNU" "Linux Programmer's Manual" .SH NAME res_init, res_query, res_search, res_querydomain, res_mkquery, res_send, dn_comp, dn_expand \- resolver routines @@ -90,7 +90,7 @@ The .BR res_init () function reads the configuration files (see .BR resolv.conf (5)) -to get the default domain name, search order and name +to get the default domain name and name server address(es). If no server is given, the local host is tried. If no domain is given, that associated with the local host is used. diff --git a/man5/host.conf.5 b/man5/host.conf.5 index a289cb4..e3d9073 100644 --- a/man5/host.conf.5 +++ b/man5/host.conf.5 @@ -23,7 +23,7 @@ .\" %%%LICENSE_END .\" .\" 2003-08-23 Martin Schulze <j...@infodrom.org> Updated according to glibc 2.3.2 -.TH HOST.CONF 5 2003-08-23 "Linux" "Linux System Administration" +.TH HOST.CONF 5 2014-05-17 "Linux" "Linux System Administration" .SH NAME host.conf \- resolver configuration file .SH DESCRIPTION @@ -32,15 +32,7 @@ The file contains configuration information specific to the resolver library. It should contain one configuration keyword per line, followed by appropriate configuration information. -The keywords recognized are -.IR order ", " trim ", " multi ", " nospoof ", " spoof ", and " reorder . -These keywords are described below. -.TP -.I order -This keyword specifies how host lookups are to be performed. -It should be followed by one or more lookup methods, separated by commas. -Valid methods are -.IR bind ", " hosts ", and " nis . +The following keywords are recognized: .TP .I trim This keyword may be listed more than once. @@ -133,19 +125,14 @@ Reordering is done for all lookup methods. The default value is .IR off . .SH ENVIRONMENT -There are six environment variables that can be used to allow users to +The following environment variables can be used to allow users to override the behavior which is configured in -.IR /etc/host.conf . +.IR /etc/host.conf : .TP .B RESOLV_HOST_CONF If set, this variable points to a file that should be read instead of .IR /etc/host.conf . .TP -.B RESOLV_SERV_ORDER -Overrides the -.I order -command. -.TP .B RESOLV_SPOOF_CHECK Overrides the .IR nospoof ", " spoofalert " and " spoof @@ -196,8 +183,25 @@ and a new environment variable can take arguments like .IR off ", " nowarn " and " warn . Line comments can appear anywhere and not only at the beginning of a line. +.SS Historical +In glibc 2.4 and earlier, the following keyword is recognized: +.TP +.I order +This keyword specifies how host lookups are to be performed. +It should be followed by one or more lookup methods, separated by commas. +Valid methods are +.IR bind ", " hosts ", and " nis . +The +.B RESOLV_SERV_ORDER +environment variable could be used to override the +.I order +command. +.PP +The +.BR nsswitch.conf (5) +file is the modern way of controlling the order of host lookups. .SH SEE ALSO .BR gethostbyname (3), +.BR nsswitch.conf (5) .BR hostname (7), -.BR named (8), -.BR resolv+ (8) +.BR named (8) diff --git a/man5/resolv.conf.5 b/man5/resolv.conf.5 index 3680a82..f9a0ba1 100644 --- a/man5/resolv.conf.5 +++ b/man5/resolv.conf.5 @@ -20,7 +20,7 @@ .\" .\" Added ndots remark by Bernhard R. Link - debian bug #182886 .\" -.TH RESOLV.CONF 5 2014-02-22 "" "Linux Programmer's Manual" +.TH RESOLV.CONF 5 2014-05-17 "" "Linux Programmer's Manual" .UC 4 .SH NAME resolv.conf \- resolver configuration file @@ -290,6 +290,7 @@ in the first column are treated as comments. .SH SEE ALSO .BR gethostbyname (3), .BR resolver (3), +.BR nsswitch.conf (5) .BR hostname (7), .BR named (8) .br -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/ -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/ -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
