[PATCH] resolv.conf.5: Describe single-request option

[PATCH] resolv.conf.5: Describe single-request option

[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).

Signed-off-by: Petr Baudis <pasky-AlSwsSmVLrQ@public.gmane.org>

---

Ping, what about the other patches? ;-)

diff --git a/man3/resolver.3 b/man3/resolver.3
index eabc1a4..181468a 100644
--- a/man3/resolver.3
+++ b/man3/resolver.3
@@ -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 ()
diff --git a/man5/resolv.conf.5 b/man5/resolv.conf.5
index 4d67c75..2a2c694 100644
--- a/man5/resolv.conf.5
+++ b/man5/resolv.conf.5
@@ -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 majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] resolv.conf.5: Describe single-request option

[Petr Baudis]

On Fri, May 15, 2009 at 07:17:13PM +0200, Petr Baudis wrote:
> 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).
> 
> Signed-off-by: Petr Baudis <pasky-AlSwsSmVLrQ@public.gmane.org>

Ping...

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

Re: [PATCH] resolv.conf.5: Describe single-request option

[Petr Baudis]

On Sun, Sep 20, 2009 at 05:03:54PM +0200, Petr Baudis wrote:
> On Fri, May 15, 2009 at 07:17:13PM +0200, Petr Baudis wrote:
> > 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).
> > 
> > Signed-off-by: Petr Baudis <pasky-AlSwsSmVLrQ@public.gmane.org>
> 
> Ping...

Ping...

-- 
				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 majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] resolv.conf.5: Describe single-request option

[Michael Kerrisk (man-pages)]

tags 607398 fixed-upstream
thanks

Petr,

On Sat, May 16, 2009 at 5:17 AM, Petr Baudis <pasky-AlSwsSmVLrQ@public.gmane.org> wrote:
> 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).
>
> Signed-off-by: Petr Baudis <pasky-AlSwsSmVLrQ@public.gmane.org>
>
> ---
>
> Ping, what about the other patches? ;-)
>
> diff --git a/man3/resolver.3 b/man3/resolver.3
> index eabc1a4..181468a 100644
> --- a/man3/resolver.3
> +++ b/man3/resolver.3
> @@ -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 ()

I applied these two patches separately.

> diff --git a/man5/resolv.conf.5 b/man5/resolv.conf.5
> index 4d67c75..2a2c694 100644
> --- a/man5/resolv.conf.5
> +++ b/man5/resolv.conf.5
> @@ -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.

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

--- a/man5/resolv.conf.5
+++ b/man5/resolv.conf.5
@@ -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.


-- 
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 majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html