[src/trunk]: src/share/man/man5 document missing resolv.conf options

[christos <christos%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/11640a178caa
branches:  trunk
changeset: 781480:11640a178caa
user:      christos <christos%NetBSD.org@localhost>
date:      Sun Sep 09 16:38:52 2012 +0000

description:
document missing resolv.conf options

diffstat:

 share/man/man5/resolv.conf.5 |  67 ++++++++++++++++++++++++++++++++++++-------
 1 files changed, 56 insertions(+), 11 deletions(-)

diffs (99 lines):

diff -r b509155c3f70 -r 11640a178caa share/man/man5/resolv.conf.5
--- a/share/man/man5/resolv.conf.5      Sun Sep 09 16:07:20 2012 +0000
+++ b/share/man/man5/resolv.conf.5      Sun Sep 09 16:38:52 2012 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: resolv.conf.5,v 1.27 2011/08/21 13:27:45 wiz Exp $
+.\"    $NetBSD: resolv.conf.5,v 1.28 2012/09/09 16:38:52 christos Exp $
 .\"
 .\" Copyright (c) 1986, 1991 The Regents of the University of California.
 .\" All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"     @(#)resolver.5 5.12 (Berkeley) 5/10/91
 .\"
-.Dd August 21, 2010
+.Dd September 9, 2012
 .Dt RESOLV.CONF 5
 .Os
 .Sh NAME
@@ -135,11 +135,48 @@
 .Sy options option ...
 .Pp
 where option is one of the following:
-.Bl -tag -width insecure1
+.Bl -tag -width no-check-names
 .It Sy debug
 enable debugging information, by setting RES_DEBUG in _res.options
 (see
 .Xr resolver 3 ) .
+.It Sy ndots:n
+sets a threshold for the number of dots which
+must appear in a name given to res_query (see
+.Xr resolver 3 )
+before an initial absolute query will be made.
+The default for n is 1, meaning that if there are any
+dots in a name, the name will be tried first as an absolute
+name before any search list elements are appended to it.
+.It Sy timeout:n
+sets the amount of time the resolver will wait for a response from a remote
+name server before retrying the query via a different name server.  Measured in
+seconds, the default is
+.Dv RES_TIMEOUT
+(see
+.Pa <resolv.h> ) .
+.It Sy attempts:n
+sets the number of times the resolver will send a query to its name servers
+before giving up and returning an error to the calling application.  The
+default is
+.Dv RES_DFLRETRY
+(see
+.Pa <resolv.h> ) .
+.It Sy rotate
+sets
+.Dv RES_ROTATE
+in
+.Ft _res.options ,
+which causes round robin selection of nameservers 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.
+.It Sy no-check-names
+sets
+.Dv RES_NOCHECKNAME
+in
+.Ft _res.options ,
+which disables the modern BIND checking of incoming host names and mail names
+for invalid characters such as underscore (_), non-ASCII, or control characters.
 .It Sy edns0
 attach OPT pseudo-RR for ENDS0 extension specified in RFC 2671,
 to inform DNS server of our receive buffer size.
@@ -163,14 +200,22 @@
 Do not check if the query section of the reply packet is equal
 to that of the query packet.
 For testing purposes only.
-.It Sy ndots:n
-sets a threshold for the number of dots which
-must appear in a name given to res_query (see
-.Xr resolver 3 )
-before an initial absolute query will be made.
-The default for n is 1, meaning that if there are any
-dots in a name, the name will be tried first as an absolute
-name before any search list elements are appended to it.
+.It Sy no-tld-query
+sets
+.Dv RES_NOTLDQUERY
+in
+.Ft _res.options .
+This option causes
+.Fn res_nsearch
+to not attempt to resolve a unqualified name as if it were a top level  
+domain (TLD).
+This option can cause problems if the site has "localhost" as a TLD rather
+than having localhost on one or more elements of the search list.
+This option has no effect if neither
+.Dv RES_DEFNAMES
+or
+.Dv RES_DNSRCH
+is set.
 .El
 .El
 .Pp