LDP: Update original to LDP v3.79

[linuxjm/LDP_man-pages.git] / original / man5 / resolv.conf.5

diff --git a/original/man5/resolv.conf.5 b/original/man5/resolv.conf.5
index 7efb561..5aaddb3 100644 (file)
--- a/original/man5/resolv.conf.5
+++ b/original/man5/resolv.conf.5
@@ -20,7 +20,7 @@
 .\"
 .\" Added ndots remark by Bernhard R. Link - debian bug #182886
 .\"
-.TH RESOLV.CONF 5 2013-03-05 "" "Linux Programmer's Manual"
+.TH RESOLV.CONF 5 2014-12-31 "" "Linux Programmer's Manual"
 .UC 4
 .SH NAME
 resolv.conf \- resolver configuration file
@@ -35,6 +35,9 @@ The resolver configuration file contains information that is read
 by the resolver routines the first time they are invoked by a process.
 The file is designed to be human readable and contains a list of
 keywords with values that provide various types of resolver information.
+The configuration file is considered a trusted source of DNS information
+(e.g., DNSSEC AD-bit information will be returned unmodified from this
+source).
 .LP
 If this file does not exist,
 only the name server on the local machine will be queried;
@@ -63,6 +66,7 @@ until a maximum number of retries are made.)
 \fBdomain\fP Local domain name.
 Most queries for names within this domain can use short names
 relative to the local domain.
+If set to \(aq.\(aq, the root domain is considered.
 If no \fBdomain\fP entry is present, the domain is determined
 from the local hostname returned by
 .BR gethostname (2);
@@ -136,7 +140,7 @@ sets
 .BR RES_DEBUG
 in
 .IR _res.options
-(only effective if glibc was built with debug support; see
+(effective only if glibc was built with debug support; see
 .BR resolver (3)).
 .TP
 .BI ndots: n
@@ -179,7 +183,7 @@ sets
 .BR RES_ROTATE
 in
 .IR _res.options ,
-which causes round-robin selection of nameservers from among those listed.
+which 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
@@ -252,11 +256,22 @@ resolving process).
 .TP
 .BR single-request-reopen " (since glibc 2.9)"
 The resolver uses the same socket for the A and AAAA requests.
-Some hardware mistakenly only sends back one reply.
+Some hardware mistakenly sends back only one reply.
 When that happens the client system will sit and wait for the second reply.
 Turning this option on changes this behavior
 so that if two requests from the same port are not handled correctly it will
-close the  socket and open a new one before sending the second request.
+close the socket and open a new one before sending the second request.
+.TP
+.BR no-tld-query " (since glibc 2.14)"
+sets RES_NOTLDQUERY in
+.IR _res.options .
+This option causes
+.BR res_nsearch ()
+to not attempt to resolve an 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 RES_DEFNAMES or RES_DNSRCH is set.
 .RE
 .LP
 The \fIdomain\fP and \fIsearch\fP keywords are mutually exclusive.
@@ -290,3 +305,12 @@ in the first column are treated as comments.
 .BR named (8)
 .br
 Name Server Operations Guide for BIND
+.SH COLOPHON
+This page is part of release 3.79 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.