new copyright notice

[unix-history] / usr / src / share / man / man5 / resolver.5

diff --git a/usr/src/share/man/man5/resolver.5 b/usr/src/share/man/man5/resolver.5
index 7fb10bd..31af2a9 100644 (file)
--- a/usr/src/share/man/man5/resolver.5
+++ b/usr/src/share/man/man5/resolver.5
@@ -1,36 +1,88 @@
-.\"    @(#)resolver.5  5.4 (Berkeley) %G%
+.\" Copyright (c) 1986 The Regents of the University of California.
+.\" All rights reserved.

 .\"
 .\"

-.TH RESOLVER 5 "1 January 1986"
+.\" %sccs.include.redist.man%
+.\"
+.\"    @(#)resolver.5  5.10 (Berkeley) %G%
+.\"
+.TH RESOLVER 5 ""

 .UC 4
 .SH NAME
 .UC 4
 .SH NAME

-resolver configuration file
+resolver \- resolver configuration file
+.SH SYNOPSIS
+/etc/resolv.conf

 .SH DESCRIPTION
 .LP
 .SH DESCRIPTION
 .LP

+The
+.I resolver
+is a set of routines in the C library (\c
+.IR resolv (3))
+that provide access to the Internet Domain Name System.

 The resolver configuration file contains information that is read
 The resolver configuration file contains information that is read

-by the resolver routines the first time they are invoked in a process.
+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
 The file is designed to be human readable and contains a list of

-name-value pairs that provide various types of resolver information.
+keywords with values that provide various types of resolver information.
+.LP
+On a normally configured system this file should not be necessary.
+The only name server to be queried will be on the local machine,
+the domain name is determined from the host name,
+and the domain search path is constructed from the domain name.

 .LP
 The different configuration options are:
 .TP
 \fBnameserver\fP
 .LP
 The different configuration options are:
 .TP
 \fBnameserver\fP

-followed by the Internet address (in dot notation) of a name server
-that the resolver should query.  At least one name server should be
-listed.  Up to MAXNS (currently 3) name servers may be listed, in that
-case the resolver library queries tries them in the order listed.
+Internet address (in dot notation) of a name server
+that the resolver should query.
+Up to MAXNS (currently 3) name servers may be listed,
+one per keyword.
+If there are multiple servers,
+the resolver library queries them in the order listed.
+If no \fBnameserver\fP entries are present,
+the default is to use the name server on the local machine.

 (The algorithm used is to try a name server, and if the query times out,
 (The algorithm used is to try a name server, and if the query times out,

-try the next, until out of name servers, then repeat trying all the name servers
+try the next, until out of name servers,
+then repeat trying all the name servers

 until a maximum number of retries are made).
 .TP
 \fBdomain\fP
 until a maximum number of retries are made).
 .TP
 \fBdomain\fP

-followed by a domain name, that is
-the default domain to append to names that do not have a dot in them.
-This defaults to empty (the root domain).
+Local domain name.
+Most queries for names within this domain can use short names
+relative to the local domain.
+If no \fBdomain\fP entry is present, the domain is determined
+from the local host name returned by
+\fIgethostname\fP\|(2);
+the domain part is taken to be everything after the first `.'.
+Finally, if the host name does not contain a domain part, the root
+domain is assumed.
+.TP
+\fBsearch\fP
+Search list for host-name lookup.
+The search list is normally determined from the local domain name;
+by default, it begins with the local domain name, then successive
+parent domains that have at least two components in their names.
+This may be changed by listing the desired domain search path
+following the \fIsearch\fP keyword with spaces or tabs separating
+the names.
+Most resolver queries will be attempted using each component
+of the search path in turn until a match is found.
+Note that this process may be slow and will generate a lot of network
+traffic if the servers for the listed domains are not local,
+and that queries will time out if no server is available
+for one of the domains.
+.IP
+The search list is currently limited to six domains
+with a total of 256 characters.
+.LP
+The \fIdomain\fP and \fIsearch\fP keywords are mutually exclusive.
+If more than one instance of these keywords is present,
+the last instance will override.

 .LP
 .LP

-The name value pair must appear on a single line, and the keyword
+The keyword and value must appear on a single line, and the keyword

 (e.g. \fBnameserver\fP) must start the line.  The value follows
 the keyword, separated by white space.
 .SH FILES
 .I /etc/resolv.conf
 .SH SEE ALSO
 (e.g. \fBnameserver\fP) must start the line.  The value follows
 the keyword, separated by white space.
 .SH FILES
 .I /etc/resolv.conf
 .SH SEE ALSO

-gethostent(3n), resolver(3), named(8), Name Server Operations Guide for BIND
+gethostbyname(3N), resolver(3), hostname(7), named(8)
+.br
+Name Server Operations Guide for BIND