Skip to contentSkip to conversation

resolv.conf.5: Describe single-request option

PATCH In review Petr Baudis 2 participants 4 messages May 15, 2009 – Apr 23, 2012 2 messages not in the archive Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 resolv.conf.5: Describe single-request option

The single-request option was introduced with glibc-2.10.

Also, a note is added to resolver(3) that many of the options are actually described in resolv.conf(5).

---

Ping, what about the other patches? ;-)

man3/resolver.3 +3 -0
index eabc1a4..181468a 100644
@@ -232,6 +232,9 @@ domain and in parent domains.
 This option is used by
 .BR gethostbyname (3).
 [Enabled by default].
+.PP
+This list is not complete. You can find some other flags described in
+.BR resolv.conf (5).
 .SH "RETURN VALUE"
 The
 .BR res_init ()
man5/resolv.conf.5 +13 -0
index 4d67c75..2a2c694 100644
@@ -231,6 +231,19 @@ sets
 in
 .IR _res.options .
 This enables support for the DNS extensions described in RFC\ 2671.
+.TP
+.BR single-request " (since glibc 2.10)"
+sets
+.BR RES_SNGLKUP
+in
+.IR _res.options .
+By default, glibc performs IPv4 and IPv6 lookups in parallel since
+version 2.9 (though many distribution packages of glibc are known
+to disable that behavior in this version). Some appliance DNS servers
+cannot handle these queries properly and make the requests time out.
+This option disables the behavior and makes glibc perform the IPv6
+and IPv4 requests sequentially (at the cost of some slowdown of the
+resolving process).
 .RE
 .LP
 The \fIdomain\fP and \fIsearch\fP keywords are mutually exclusive.

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html

A message that is not in the archive (sent off-list or not yet received): [email protected]

#2 lore raw
Quoted 6 lines · Petr Baudis

The single-request option was introduced with glibc-2.10.

Also, a note is added to resolver(3) that many of the options are actually described in resolv.conf(5).

Ping...

Petr "Pasky" Baudis
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html

A message that is not in the archive (sent off-list or not yet received): [email protected]

#4 lore raw
Quoted 9 lines · Petr Baudis
Quoted 6 lines · Petr Baudis

The single-request option was introduced with glibc-2.10.

Also, a note is added to resolver(3) that many of the options are actually described in resolv.conf(5).

Ping...

Ping...

Signature · 7 lines
				Petr "Pasky" Baudis
A great many people think they are thinking when they are merely
rearranging their prejudices. -- William James
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html
#5 lore raw
In reply to a message not in the archive

tags 607398 fixed-upstream
thanks

Petr,

Quoted 17 lines · Petr Baudis

The single-request option was introduced with glibc-2.10.

Also, a note is added to resolver(3) that many of the options are actually described in resolv.conf(5).

---

Ping, what about the other patches? ;-)

man3/resolver.3 +0 -0
index eabc1a4..181468a 100644
@@ -232,6 +232,9 @@ domain and in parent domains.

 This option is used by

Quoted 8 lines

 .BR gethostbyname (3).
 [Enabled by default].
+.PP
+This list is not complete. You can find some other flags described in +.BR resolv.conf (5).
 .SH "RETURN VALUE"
 The
 .BR res_init ()

I applied these two patches separately.

Quoted 21 lines
man5/resolv.conf.5 +0 -0
index 4d67c75..2a2c694 100644
@@ -231,6 +231,19 @@ sets

 in
 .IR _res.options .
 This enables support for the DNS extensions described in RFC\ 2671. +.TP
+.BR single-request " (since glibc 2.10)"

man5/resolv.conf.5 +11 -0
+sets
+.BR RES_SNGLKUP
+in
+.IR _res.options .
+By default, glibc performs IPv4 and IPv6 lookups in parallel since
+version 2.9 (though many distribution packages of glibc are known
+to disable that behavior in this version). Some appliance DNS servers
+cannot handle these queries properly and make the requests time out.
+This option disables the behavior and makes glibc perform the IPv6
+and IPv4 requests sequentially (at the cost of some slowdown of the
+resolving process).
Quoted 3 lines

 .RE
 .LP
 The \fIdomain\fP and \fIsearch\fP keywords are mutually exclusive.

I applied a slightly modified version of the above patch that dropped the details about distros. See below.

These patches will appear in man-pages-3.40.

Cheers,

Michael

man5/resolv.conf.5 +13 -0
@@ -231,6 +231,19 @@ sets
 in
 .IR _res.options .
 This enables support for the DNS extensions described in RFC\ 2671.
+.TP
+.BR single-request " (since glibc 2.10)"
+sets
+.BR RES_SNGLKUP
+in
+.IR _res.options .
+By default, glibc performs IPv4 and IPv6 lookups in parallel since
+version 2.9.
+Some appliance DNS servers
+cannot handle these queries properly and make the requests time out.
+This option disables the behavior and makes glibc perform the IPv6
+and IPv4 requests sequentially (at the cost of some slowdown of the
+resolving process).
 .RE
 .LP
 The \fIdomain\fP and \fIsearch\fP keywords are mutually exclusive.
Signature · 7 lines
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface"; http://man7.org/tlpi/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html