Module Name: src
Committed By: christos
Date: Sun Sep 9 16:38:52 UTC 2012
Modified Files:
src/share/man/man5: resolv.conf.5
Log Message:
document missing resolv.conf options
To generate a diff of this commit:
cvs rdiff -u -r1.27 -r1.28 src/share/man/man5/resolv.conf.5
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man5/resolv.conf.5
diff -u src/share/man/man5/resolv.conf.5:1.27 src/share/man/man5/resolv.conf.5:1.28
--- src/share/man/man5/resolv.conf.5:1.27 Sun Aug 21 09:27:45 2011
+++ src/share/man/man5/resolv.conf.5 Sun Sep 9 12:38:52 2012
@@ -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 @@ The syntax is:
.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 @@ servers' address.
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
