[PATCH] resolver.3: documents missing options used by _res structure defined in resolv.h and indicates defaults options

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Missing options: RES_INSECURE1, RES_INSECURE2, RES_NOALIASES, USE_INET6,
ROTATE, NOCHECKNAME, RES_KEEPTSIG, BLAST, USEBSTRING, NOIP6DOTINT, USE_EDNS0,
SNGLKUP, SNGLKUPREOP, RES_USE_DNSSEC, NOTLDQUERY, DEFAULT

Written from the glibc source and resolv.conf.5.

Debian bug #527136 reported by Jakub Wilk <ubanus@xxxxxxxxxxxx> [1]

[1] https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=527136

Signed-off-by: Stéphane Aulery <saulery@xxxxxxx>
---
 man3/resolver.3 | 86 +++++++++++++++++++++++++++++++++++++++++++++++++++++----
 1 file changed, 81 insertions(+), 5 deletions(-)

diff --git a/man3/resolver.3 b/man3/resolver.3
index 19c4192..1b22708 100644
--- a/man3/resolver.3
+++ b/man3/resolver.3
@@ -204,7 +204,7 @@ implemented].
 Use TCP connections for queries rather than UDP datagrams.
 .TP
 .B RES_PRIMARY
-Query primary domain name server only.
+Query primary domain name server only. [Not currently implemented].
 .TP
 .B RES_IGNTC
 Ignore truncation errors.
@@ -238,10 +238,86 @@ 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).
+.TP
+.B RES_INSECURE1
+Accept a response from a wrong server and show it on stdout (for debug
+purpose only).
+.TP
+.B RES_INSECURE2
+Accept a response which contains a wrong query and show it on stdout (for
+debug purpose only).
+.TP
+.B RES_NOALIASES
+Disable usage of
+.B HOSTALIASES
+environment variable.
+.TP
+.B RES_USE_INET6
+Try a AAAA query before an A query inside the
+.BR gethostbyname ()
+function, and map IPv4 responses in IPv6 "tunneled form" if no AAAA
+records are found but an A record set exists.
+.TP
+.B RES_ROTATE
+Causes round-robin selection of name servers from among those listed. This
+has the effect of spreading the query load among all listed servers, rather
+than having all clients try the first listed server first every time.
+.TP
+.B RES_NOCHECKNAME
+Disable the modern BIND checking of incoming hostnames and mail names
+for invalid characters such as underscore (_), non-ASCII, or control
+characters. [Not currently implemented].
+.TP
+.B RES_KEEPTSIG
+Do not strip TSIG records. [Not currently implemented].
+.TP
+.B RES_BLAST
+When resolvers want to even out the load on their nameservers, following
+them. Note this option overrides
+.BR RES_ROTATE .
+.TP
+.B RES_USEBSTRING
+Make reverse IPv6 lookups using the bit-label format described in RFC 2673;
+if this option is not set, then nibble format is used (since glibc 2.3.4).
+.TP
+.B RES_NOIP6DOTINT
+Use
+.I ip6.arpa
+zone in IPv6 reverse lookup instead of
+.I ip6.int
+which is deprecated since glibc 2.3.4. [Enabled by default].
+.TP
+.B RES_USE_EDNS0
+Enables support for the DNS extensions (EDNS0) described in RFC 2671 (since
+glibc 2.6).
+.TP
+.B RES_SNGLKUP
+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) (since glibc 2.10).
+.TP
+.B RES_SNGLKUPREOP
+When
+.B RES_SNGLKUP
+option is enabled, opens a new socket for the each request.
+.TP
+.B RES_USE_DNSSEC
+Use DNSSEC with OK bit in OPT record. This option implies
+.BR RES_USE_EDNS0 .
+.TP
+.B RES_NOTLDQUERY
+Do not look up unqualified name as a TLD.
+.TP
+.B RES_DEFAULT
+Default option which implies:
+.BR RES_RECURSE ,
+.BR RES_DEFNAMES ,
+.BR RES_DNSRCH
+and
+.BR RES_NOIP6DOTINT .
+
 .SH RETURN VALUE
 The
 .BR res_init ()
-- 
2.1.4

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




[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux