resolver.5 (123236) | resolver.5 (130582) |
---|---|
1.\" Copyright (c) 1986, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 16 unchanged lines hidden (view full) --- 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" 32.\" @(#)resolver.5 8.1 (Berkeley) 6/5/93 | 1.\" Copyright (c) 1986, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 16 unchanged lines hidden (view full) --- 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" 32.\" @(#)resolver.5 8.1 (Berkeley) 6/5/93 |
33.\" $FreeBSD: head/share/man/man5/resolver.5 123236 2003-12-07 12:32:24Z murray $ | 33.\" $FreeBSD: head/share/man/man5/resolver.5 130582 2004-06-16 08:33:57Z ru $ |
34.\" | 34.\" |
35.Dd November 11, 1993 | 35.Dd December 7, 2003 |
36.Dt RESOLVER 5 37.Os 38.Sh NAME 39.Nm resolver 40.Nd resolver configuration file 41.Sh SYNOPSIS 42.Nm resolv.conf 43.Sh DESCRIPTION --- 34 unchanged lines hidden (view full) --- 78Local domain name. 79Most queries for names within this domain can use short names 80relative to the local domain. 81If no 82.Sy domain 83entry is present, the domain is determined 84from the local host name returned by 85.Xr gethostname 3 ; | 36.Dt RESOLVER 5 37.Os 38.Sh NAME 39.Nm resolver 40.Nd resolver configuration file 41.Sh SYNOPSIS 42.Nm resolv.conf 43.Sh DESCRIPTION --- 34 unchanged lines hidden (view full) --- 78Local domain name. 79Most queries for names within this domain can use short names 80relative to the local domain. 81If no 82.Sy domain 83entry is present, the domain is determined 84from the local host name returned by 85.Xr gethostname 3 ; |
86the domain part is taken to be everything after the first `.'. | 86the domain part is taken to be everything after the first 87.Ql \&. . |
87Finally, if the host name does not contain a domain part, the root 88domain is assumed. 89.It Sy search 90Search list for host-name lookup. 91The search list is normally determined from the local domain name; 92by default, it contains only the local domain name. 93This may be changed by listing the desired domain search path 94following the --- 13 unchanged lines hidden (view full) --- 108Sortlist allows addresses returned by gethostbyname to be sorted. 109A sortlist is specified by IP address netmask pairs. 110The netmask is 111optional and defaults to the natural netmask of the net. 112The IP address 113and optional network pairs are separated by slashes. 114Up to 10 pairs may 115be specified. | 88Finally, if the host name does not contain a domain part, the root 89domain is assumed. 90.It Sy search 91Search list for host-name lookup. 92The search list is normally determined from the local domain name; 93by default, it contains only the local domain name. 94This may be changed by listing the desired domain search path 95following the --- 13 unchanged lines hidden (view full) --- 109Sortlist allows addresses returned by gethostbyname to be sorted. 110A sortlist is specified by IP address netmask pairs. 111The netmask is 112optional and defaults to the natural netmask of the net. 113The IP address 114and optional network pairs are separated by slashes. 115Up to 10 pairs may 116be specified. |
117E.g., |
|
116.Pp | 118.Pp |
117e.g. sortlist 130.155.160.0/255.255.240.0 130.155.0.0 | 119.Dl "sortlist 130.155.160.0/255.255.240.0 130.155.0.0" |
118.It Sy options 119Options allows certain internal resolver variables to be modified. 120The syntax is 121.Pp 122\fBoptions\fP \fIoption\fP \fI...\fP 123.Pp 124where 125.Sy option --- 17 unchanged lines hidden (view full) --- 143is 144.Dq 1 , 145meaning that if there are any dots in a name, the name 146will be tried first as an absolute name before any 147.Em search list 148elements are appended to it. 149.It Sy timeout: Ns Ar n 150sets the amount of time the resolver will wait for a response from a remote | 120.It Sy options 121Options allows certain internal resolver variables to be modified. 122The syntax is 123.Pp 124\fBoptions\fP \fIoption\fP \fI...\fP 125.Pp 126where 127.Sy option --- 17 unchanged lines hidden (view full) --- 145is 146.Dq 1 , 147meaning that if there are any dots in a name, the name 148will be tried first as an absolute name before any 149.Em search list 150elements are appended to it. 151.It Sy timeout: Ns Ar n 152sets the amount of time the resolver will wait for a response from a remote |
151name server before retrying the query via a different name server. Measured in 152seconds, the default is | 153name server before retrying the query via a different name server. 154Measured in seconds, the default is |
153.Dv RES_TIMEOUT 154(see | 155.Dv RES_TIMEOUT 156(see |
155.Pa <resolv.h> ) . | 157.In resolv.h ) . |
156.It Sy attempts: Ns Ar n 157sets the number of times the resolver will send a query to its name servers | 158.It Sy attempts: Ns Ar n 159sets the number of times the resolver will send a query to its name servers |
158before giving up and returning an error to the calling application. The 159default is | 160before giving up and returning an error to the calling application. 161The default is |
160.Dv RES_DFLRETRY 161(see | 162.Dv RES_DFLRETRY 163(see |
162.Pa <resolv.h> ) . | 164.In resolv.h ) . |
163.It Sy no_tld_query 164tells the resolver not to attempt to resolve a top level domain name, that | 165.It Sy no_tld_query 166tells the resolver not to attempt to resolve a top level domain name, that |
165is, a name that contains no dots. Use of this option doesn't prevent | 167is, a name that contains no dots. 168Use of this option does not prevent |
166the resolver from obeying the standard 167.Sy domain 168and 169.Sy search 170rules with the given name. 171.El 172.Pp 173Options may also be specified as a space or tab separated list using the --- 7 unchanged lines hidden (view full) --- 181.Sy search 182keywords are mutually exclusive. 183If more than one instance of these keywords is present, 184the last instance will override. 185.Pp 186The keyword and value must appear on a single line, and the keyword 187(e.g.\& 188.Sy nameserver ) | 169the resolver from obeying the standard 170.Sy domain 171and 172.Sy search 173rules with the given name. 174.El 175.Pp 176Options may also be specified as a space or tab separated list using the --- 7 unchanged lines hidden (view full) --- 184.Sy search 185keywords are mutually exclusive. 186If more than one instance of these keywords is present, 187the last instance will override. 188.Pp 189The keyword and value must appear on a single line, and the keyword 190(e.g.\& 191.Sy nameserver ) |
189must start the line. The value follows 190the keyword, separated by white space. | 192must start the line. 193The value follows the keyword, separated by white space. |
191.Sh FILES 192.Bl -tag -width /etc/resolv.conf -compact 193.It Pa /etc/resolv.conf 194The file 195.Nm resolv.conf 196resides in 197.Pa /etc . 198.El --- 13 unchanged lines hidden --- | 194.Sh FILES 195.Bl -tag -width /etc/resolv.conf -compact 196.It Pa /etc/resolv.conf 197The file 198.Nm resolv.conf 199resides in 200.Pa /etc . 201.El --- 13 unchanged lines hidden --- |