diff options
Diffstat (limited to 'usr/src/man/man4/resolv.conf.4')
| -rw-r--r-- | usr/src/man/man4/resolv.conf.4 | 257 |
1 files changed, 0 insertions, 257 deletions
diff --git a/usr/src/man/man4/resolv.conf.4 b/usr/src/man/man4/resolv.conf.4 deleted file mode 100644 index 855acd44e2..0000000000 --- a/usr/src/man/man4/resolv.conf.4 +++ /dev/null @@ -1,257 +0,0 @@ -'\" te -.\" Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved. -.\" Copyright 1989 AT&T -.\" Copyright (c) 1983 Regents of the University of California. All rights reserved. The Berkeley software License Agreement specifies the terms and conditions for redistribution. -.TH RESOLV.CONF 4 "Dec 15, 2004" -.SH NAME -resolv.conf \- resolver configuration file -.SH SYNOPSIS -.LP -.nf -\fB/etc/resolv.conf\fR -.fi - -.SH DESCRIPTION -.sp -.LP -The \fBresolver\fR is a set of routines that provide access to the Internet -Domain Name System. See \fBresolver\fR(3RESOLV). \fBresolv.conf\fR is a -configuration file that contains the information that is read by the -\fBresolver\fR 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 \fBresolver\fR information. -.sp -.LP -The \fBresolv.conf\fR file contains the following configuration directives: -.sp -.ne 2 -.na -\fB\fBnameserver\fR\fR -.ad -.RS 23n -Specifies the IPv4 or IPv6 Internet address of a name server that the resolver -is to query. Up to \fIMAXNS\fR name servers may be listed, one per keyword. See -<\fBresolv.h\fR>. If there are multiple servers, the resolver library queries -them in the order listed. If no name server entries are present, the resolver -library queries the name server on the local machine. The resolver library -follows the algorithm to try a name server until the query times out. It then -tries the name servers that follow, until each query times out. It repeats all -the name servers until a maximum number of retries are made. -.RE - -.sp -.ne 2 -.na -\fB\fBdomain\fR\fR -.ad -.RS 23n -Specifies the local domain name. Most queries for names within this domain can -use short names relative to the local domain. If no domain entry is present, -the domain is determined from \fBsysinfo\fR(2) or from \fBgethostname\fR(3C). -(Everything after the first `.' is presumed to be the domain name.) If the host -name does not contain a domain part, the root domain is assumed. You can use -the \fBLOCALDOMAIN\fR environment variable to override the domain name. -.RE - -.sp -.ne 2 -.na -\fB\fBsearch\fR\fR -.ad -.RS 23n -The search list for host name lookup. The search list is normally determined -from the local domain name. By default, it contains only the local domain name. -You can change the default behavior by listing the desired domain search path -following the search keyword, with spaces or tabs separating the names. Most -\fBresolver\fR queries will be attempted using each component of the search -path in turn until a match is found. This process may be slow and will generate -a lot of network traffic if the servers for the listed domains are not local. -Queries will time out if no server is available for one of the domains. -.sp -The search list is currently limited to six domains and a total of 256 -characters. -.RE - -.sp -.ne 2 -.na -\fB\fBsortlist\fR\fIaddresslist\fR\fR -.ad -.RS 23n -Allows addresses returned by the libresolv-internal \fBgethostbyname()\fR to be -sorted. A \fBsortlist\fR is specified by IP address netmask pairs. The netmask -is optional and defaults to the natural netmask of the net. The IP address and -optional network pairs are separated by slashes. Up to 10 pairs may be -specified. For example: -.sp -.in +2 -.nf -sortlist 130.155.160.0/255.255.240.0 130.155.0.0 -.fi -.in -2 -.sp - -.RE - -.sp -.ne 2 -.na -\fB\fBoptions\fR\fR -.ad -.RS 23n -Allows certain internal resolver variables to be modified. The syntax is -.sp -.in +2 -.nf -options option ... -.fi -.in -2 -.sp - -where option is one of the following: -.sp -.ne 2 -.na -\fB\fBdebug\fR\fR -.ad -.RS 18n -Sets \fBRES_DEBUG\fR in the \fB_res.options\fR field. -.RE - -.sp -.ne 2 -.na -\fB\fBndots:\fR\fIn\fR\fR -.ad -.RS 18n -Sets a threshold floor for the number of dots which must appear in a name given -to \fBres_query()\fR before an initial absolute (as-is) query is performed. See -\fBresolver\fR(3RESOLV). The default value for \fIn\fR is 1, which means that -if there are any dots in a name, the name is tried first as an absolute name -before any search list elements are appended to it. -.RE - -.sp -.ne 2 -.na -\fB\fBtimeout:\fR\fIn\fR\fR -.ad -.br -.na -\fB\fBretrans:\fR\fIn\fR\fR -.ad -.RS 18n -Sets the amount of time the resolver will wait for a response from a remote -name server before retrying the query by means of a different name server. -Measured in seconds, the default is \fBRES_TIMEOUT\fR. See <\fBresolv.h\fR>. -The \fBtimeout\fR and \fBretrans\fR values are the starting point for an -exponential back off procedure where the \fBtimeout\fR is doubled for every -retransmit attempt. -.RE - -.sp -.ne 2 -.na -\fB\fBattempts:\fR\fIn\fR\fR -.ad -.br -.na -\fB\fBretry:\fR\fIn\fR\fR -.ad -.RS 18n -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 \fBRES_DFLRETRY\fR. See <\fBresolv.h\fR>. -.RE - -.sp -.ne 2 -.na -\fB\fBrotate\fR\fR -.ad -.RS 18n -Sets \fBRES_ROTATE\fR in \fB_res.options\fR. The name servers are queried -round-robin from among those listed. The query load is spread among all listed -servers, rather than having all clients try the first listed server first every -time. -.RE - -.sp -.ne 2 -.na -\fB\fBno-check-names\fR\fR -.ad -.RS 18n -Sets \fBRES_NOCHECKNAME\fR in \fB_res.options\fR. This disables the modern BIND -checking of incoming host names and mail names for invalid characters such as -underscore (\fB_\fR), non-ASCII, or control characters. -.RE - -.sp -.ne 2 -.na -\fB\fBinet6\fR\fR -.ad -.RS 18n -Sets \fBRES_USE_INET6\fR in \fB_res.options\fR. In the Solaris BIND port, this -has no effect on \fBgethostbyname\fR(3NSL). To retrieve IPv6 addresses or IPv4 -addresses, use \fBgetaddrinfo\fR(3SOCKET) instead of setting \fBinet6\fR. -.RE - -.RE - -.sp -.LP -The \fBdomain\fR and \fBsearch\fR keywords are mutually exclusive. If more than -one instance of these keywords is present, the last instance takes precedence. -.sp -.LP -You can override the \fBsearch\fR keyword of the system \fBresolv.conf\fR file -on a per-process basis by setting the environment variable \fBLOCALDOMAIN\fR to -a space-separated list of search domains. -.sp -.LP -You can amend the \fBoptions\fR keyword of the system \fBresolv.conf\fR file on -a per-process basis by setting the environment variable \fBRES_OPTIONS\fR to a -space-separated list of resolver options. -.sp -.LP -The keyword and value must appear on a single line. Start the line with the -keyword, for example, \fBnameserver\fR, followed by the value, separated by -white space. -.SH FILES -.sp -.ne 2 -.na -\fB\fB/etc/resolv.conf\fR\fR -.ad -.RS 20n - -.RE - -.SH ATTRIBUTES -.sp -.LP -See \fBattributes\fR(5) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability Standard BIND 8.3.3 -.TE - -.SH SEE ALSO -.sp -.LP -\fBdomainname\fR(1M), \fBsysinfo\fR(2), \fBgethostbyname\fR(3NSL), -\fBgetnameinfo\fR(3SOCKET), \fBgetipnodebyname\fR(3SOCKET), -\fBgethostname\fR(3C), \fBresolver\fR(3RESOLV), \fBattributes\fR(5) -.sp -.LP -Vixie, Paul, Dunlap, Keven J., Karels, Michael J. \fIName Server Operations -Guide for BIND\fR. Internet Software Consortium, 1996. |
