Debian Bug report logs - #344233
resolver(3): remove references to resolv+(8)

Toggle useless messages

Message #5 received at submit@bugs.debian.org (full text, mbox, reply):

From: Marc Herbert <Marc.Herbert@ens-lyon.fr>

To: Debian Bug Tracking System <submit@bugs.debian.org>

Subject: manpages: nsswitch.conf and host.conf overlap. But how?

Date: Tue, 07 Sep 2004 02:49:32 +0200

Package: manpages
Version: 1.67-2
Severity: normal

Both host.conf and nsswitch.conf can be used to configure the lookup order
for hosts. But which one has priority ? Which one is recommended ?
Both man pages seem to ignore the existence of each other, this is very
confusing.



-- System Information:
Debian Release: 3.1
  APT prefers testing
  APT policy: (500, 'testing')
Architecture: i386 (i686)
Kernel: Linux 2.4.25-1-k7
Locale: LANG=fr, LC_CTYPE=fr (ignored: LC_ALL set to fr_FR)

-- no debconf information

Message #12 received at 270368@bugs.debian.org (full text, mbox, reply):

From: Justin Pryzby <justinpryzby@users.sourceforge.net>

To: 270368@bugs.debian.org

Subject: clone

Date: Tue, 20 Dec 2005 20:29:04 -0500

clone 270368 -1
retitle -1 manpages-dev: resolv+(8) doesn't exist
tag -1 upstream
severity -1 minor

host.conf(5) mentions resolv+(8) which does not exist.

Message #27 received at 344233-quiet@bugs.debian.org (full text, mbox, reply):

From: Bart Martens <bart.martens@advalvas.be>

To: 344233-quiet@bugs.debian.org, control@bugs.debian.org

Subject: still in 2.17-1

Date: Sat, 14 Jan 2006 10:52:31 +0100

package manpages
found 344233 2.17-1
thanks


The bug also applies to version 2.17-1.
The reference to resolv+ is also in the man page of gethostbyname.
Bug #214892 was solved by removing the reference to "resolv+".


$ grep -r "resolv+" *|sed -e "s/:.*//"|sort|uniq
debian/changelog
man3/gethostbyname.3
man5/host.conf.5
$ locate man3/gethostbyname.3 man5/host.conf.5
/usr/share/man/man3/gethostbyname.3.gz
/usr/share/man/man5/host.conf.5.gz
$ dpkg -S /usr/share/man/man3/gethostbyname.3.gz /usr/share/man/man5/host.conf.5.gz
manpages-dev: /usr/share/man/man3/gethostbyname.3.gz
manpages: /usr/share/man/man5/host.conf.5.gz
$ dpkg -l manpages manpages-dev|grep "^ii"
ii  manpages       2.17-1         Manual pages about using a GNU/Linux system
ii  manpages-dev   2.17-1         Manual pages about using GNU/Linux for devel
$ man gethostbyname|grep "resolv+"|wc -l
Reformatting gethostbyname(3), please wait...
1
$ man host.conf|grep "resolv+"|wc -l
Reformatting host.conf(5), please wait...
9
$

Message #36 received at 344233@bugs.debian.org (full text, mbox, reply):

From: Thomas Hood <jdthood@gmail.com>

To: 344233@bugs.debian.org, 344233-submitter@bugs.debian.org

Subject: Bug still exists

Date: Sun, 1 Sep 2013 03:43:31 +0200

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.

-- 
Thomas Hood

Message #44 received at 344233@bugs.debian.org (full text, mbox, reply):

From: "Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com>

To: Thomas Hood <jdthood@gmail.com>, 344233@bugs.debian.org, 344233-submitter@bugs.debian.org

Cc: mtk.manpages@gmail.com

Subject: Re: Bug#344233: Bug still exists

Date: Sat, 17 May 2014 17:23:14 +0200

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.manpages@gmail.com>
To: Simon Paillard <spaillard@debian.org>, linux-man@vger.kernel.org
CC: mtk.manpages@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 (faith@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 <joey@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/

Message #58 received at 344233-done@bugs.debian.org (full text, mbox, reply):

From: Stéphane Aulery <saulery@free.fr>

To: 344233-done@bugs.debian.org

Cc: control@bugs.debian.org

Subject: Re: Please remove references to resolv+(8)

Date: Mon, 2 Mar 2015 23:29:07 +0100

tags 344233 + wontfix
stop

See commit ac1056b5c00a6cae8e4ccb4a56fae76f84fd325d
           2005-12-13 15:23:07 (GMT)

https://git.kernel.org/cgit/docs/man-pages/man-pages.git/commit/man3/resolver.3?id=ac1056b5c00a6cae8e4ccb4a56fae76f84fd325d

Upstream has removed cross references to this page since 2005.

-- 
Stéphane Aulery

Send a report that this bug log contains spam.