diff options
author | nectar <nectar@FreeBSD.org> | 2002-05-13 19:35:44 +0000 |
---|---|---|
committer | nectar <nectar@FreeBSD.org> | 2002-05-13 19:35:44 +0000 |
commit | 85aae18cf4da9dbc5e850d30f1bbe0fcc970d6e8 (patch) | |
tree | 9a3345ec734bbe41cf8850029b794fe7ff21c26a /contrib/bind/doc | |
parent | f061e4498911e789b1489759f101997fbe736702 (diff) | |
download | FreeBSD-src-85aae18cf4da9dbc5e850d30f1bbe0fcc970d6e8.zip FreeBSD-src-85aae18cf4da9dbc5e850d30f1bbe0fcc970d6e8.tar.gz |
Resolve conflicts after import of ISC BIND 8.3.2-T1B documentation.
Diffstat (limited to 'contrib/bind/doc')
-rw-r--r-- | contrib/bind/doc/man/dig.1 | 29 | ||||
-rw-r--r-- | contrib/bind/doc/man/host.1 | 14 | ||||
-rw-r--r-- | contrib/bind/doc/man/nslookup.8 | 99 |
3 files changed, 76 insertions, 66 deletions
diff --git a/contrib/bind/doc/man/dig.1 b/contrib/bind/doc/man/dig.1 index 3e59b05..3fb8bdf 100644 --- a/contrib/bind/doc/man/dig.1 +++ b/contrib/bind/doc/man/dig.1 @@ -1,5 +1,5 @@ .\" $FreeBSD$ -.\" $Id: dig.1,v 8.4 1999/10/15 21:29:58 vixie Exp $ +.\" $Id: dig.1,v 8.8 2001/09/24 15:21:29 marka Exp $ .\" .\" ++Copyright++ 1993 .\" - @@ -101,7 +101,7 @@ Internet address. If this optional field is omitted, .Ic dig will attempt to use the default name server for your machine. .Pp -.Em Note: +.Em Note : If a domain name is specified, this will be resolved using the domain name system resolver (i.e., BIND). If your system does not support DNS, you may @@ -117,7 +117,7 @@ itself can be resolved. See .Xr resolver @FORMAT_EXT@ for information on .Pa /etc/resolv.conf . -.Sy WARNING: +.Sy WARNING : Changing .Pa /etc/resolv.conf will affect both the standard resolver library and @@ -190,7 +190,7 @@ all/any class information .Pp (See RFC 1035 for the complete list.) .Pp -.Em Note: +.Em Note : .Dq Ar Any can be used to specify a .Em class @@ -323,7 +323,7 @@ environment is saved. If not, the file .Dq Pa DiG.env is created in the current working directory. .Pp -.Em Note: +.Em Note : .Ev LOCALDEF is specific to the .Ic dig @@ -521,6 +521,13 @@ print TTLs .Bq Cm tt .It Xo .Op Cm no +.Ns Cm trunc\ \ \ \ +.Pq Cm tr +.Xc +truncate origin from names +.Bq Cm tr +.It Xo +.Op Cm no .Ns Cm cl .Xc print class info @@ -566,6 +573,13 @@ print authoritative section .Xc print additional section .Bq Cm ad +.It Xo +.Op Cm no +.Ns Cm dnssec\ \ \ +.Pq Cm \ddn +.Xc +set the DNSSEC OK bit in the OPT pseudo record +.Bq Cm nodn .It Cm pfdef set to default print flags .It Cm pfmin @@ -642,7 +656,7 @@ and options, above. .Sh FILES .Bl -tag -width "/etc/resolv.conf " -compact -.It Pa /etc/resolv.conf +.It Pa /etc/resolv.conf initial domain name and name server addresses .It Pa \./DiG.env default save file for default options @@ -673,7 +687,8 @@ rather ad hoc genesis. .Ic Dig does not consistently exit nicely (with appropriate status) when a problem occurs somewhere in the resolver -.Po Sy NOTE: +.Po +.Sy NOTE : most of the common exit cases are handled .Pc . This is particularly annoying when running in diff --git a/contrib/bind/doc/man/host.1 b/contrib/bind/doc/man/host.1 index 17c78ff..91932c5 100644 --- a/contrib/bind/doc/man/host.1 +++ b/contrib/bind/doc/man/host.1 @@ -50,7 +50,7 @@ .\" SOFTWARE. .\" - .\" --Copyright-- -.\" $Id: host.1,v 8.4 2000/02/29 03:50:47 vixie Exp $ +.\" $Id: host.1,v 8.6 2001/08/10 00:14:47 cyarnell Exp $ .\" $FreeBSD$ .\" .Dd December 15, 1994 @@ -70,7 +70,7 @@ .Ic Host looks for information about Internet hosts. It gets this information from a set of interconnected servers that are spread across the -country. By default, it simply converts between host names and +world. By default, it simply converts between host names and Internet addresses. However, with the .Dq Fl t or @@ -265,7 +265,7 @@ will give a complete download of the zone data for rutgers.edu, in the official master file format. (However the SOA record is listed twice, for arcane reasons.) .Pp -.Sy NOTE: +.Sy NOTE : .Dq Fl l is implemented by doing a complete zone transfer and then filtering out the information @@ -289,21 +289,17 @@ host name. The name file must be contained in the .Ev HOSTALIASES environment variable. .Sh ENVIRONMENT -.Bl -tag -width "/etc/resolv.conf " -compress +.Bl -tag -width "/etc/resolv.conf " -compact .It Ev HOSTALIASES Name of file containing .Pq Ar host alias , full hostname pairs. .El .Sh FILES -.Bl -tag -width "/etc/resolv.conf " -compress +.Bl -tag -width "/etc/resolv.conf " -compact .It Pa /etc/resolv.conf See .Xr resolver @FORMAT_EXT@ . -.It Ev HOSTALIASES -Name of file containing -.Pq Ar host alias , full hostname -pairs. .El .Sh SEE ALSO .Xr @INDOT@named @SYS_OPS_EXT@ , diff --git a/contrib/bind/doc/man/nslookup.8 b/contrib/bind/doc/man/nslookup.8 index 95d5dce..e33993c 100644 --- a/contrib/bind/doc/man/nslookup.8 +++ b/contrib/bind/doc/man/nslookup.8 @@ -172,7 +172,7 @@ command. Connects with the finger server on the current host. The current host is defined when a previous lookup for a host was successful and returned address information (see the -.Dq Ic set querytype=A +.Dq Ic set querytype Ns = Ns Dv A command). The .Ar name @@ -225,12 +225,13 @@ Sorts and lists the output of previous command(s) with .Xr more @CMD_EXT@ . .It Ic help -.It Ic ? +.It Ic ?\& Prints a brief summary of commands. .It Ic exit Exits the program. -.It Xo Ic set Ar keyword -.Ns Op = Ns Ar value +.It Xo +.Ic set +.Ar keyword Ns Op = Ns Ar value .Xc This command is used to change state information that affects the lookups. Valid keywords are: @@ -239,7 +240,7 @@ Valid keywords are: Prints the current values of the frequently-used options to .Ic set . Information about the current default server and host is also printed. -.It Ic class= Ns Ar value +.It Ic class Ns = Ns Ar value Change the query class to one of: .Bl -tag -width "HESIOD " .It Dv IN @@ -258,8 +259,8 @@ The class specifies the protocol group of the information. .Dv IN ; abbreviation = .Ic cl ) -.It Xo Op Ic no -.Ns Ic debug +.It Xo +.Oo Ic no Oc Ns Ic debug .Xc Turn debugging mode on. A lot more information is printed about the packet sent to the server and the resulting answer. @@ -267,18 +268,16 @@ packet sent to the server and the resulting answer. (Default = .Ic nodebug ; abbreviation = -.Xo Op Ic no -.Ns Ic deb ) -.Xc -.It Xo Op Ic no -.Ns Ic d2 +.Oo Ic no Oc Ns Ic deb ) +.It Xo +.Oo Ic no Oc Ns Ic d2 .Xc Turn exhaustive debugging mode on. Essentially all fields of every packet are printed. .Pp (Default = .Ic nod2 ) -.It Ic domain= Ns Ar name +.It Ic domain Ns = Ns Ar name Change the default domain name to .Ar name . The default domain name is appended to a lookup request depending on the @@ -302,10 +301,17 @@ command to display the list. .Xr hostname @CMD_EXT@ , .Pa /etc/resolv.conf , or -.Ev LOCALDOMAIN; +.Ev LOCALDOMAIN ; abbreviation = .Ic do ) -.It Ic srchlist= Ns Ar name1/name2/... +.It Xo +.Sm off +.Ic srchlist No = +.Ar name1 No / +.Ar name2 No / +.Ar ... +.Sm on +.Xc Change the default domain name to .Ar name1 and the domain search list @@ -331,11 +337,11 @@ command to display the list. .Xr hostname @CMD_EXT@ , .Pa /etc/resolv.conf , or -.Ev LOCALDOMAIN; +.Ev LOCALDOMAIN ; abbreviation = .Ic srchl ) -.It Xo Op Ic no -.Ns Ic defname +.It Xo +.Oo Ic no Oc Ns Ic defname .Xc If set, append the default domain name to a single-component lookup request (i.e., one that does not contain a period). @@ -343,11 +349,9 @@ If set, append the default domain name to a single-component lookup request (Default = .Ic defname ; abbreviation = -.Xo Op Ic no -.Ns Ic defname ) -.Xc -.It Xo Op Ic no -.Ns Ic search +.Oo Ic no Oc Ns Ic defname ) +.It Xo +.Oo Ic no Oc Ns Ic search .Xc If the lookup request contains at least one period but .Em doesn't @@ -357,18 +361,16 @@ to the request until an answer is received. (Default = .Ic search ; abbreviation = -.Xo Op Ic no -.Ns Ic sea ) -.Xc -.It Ic port= Ns Ar value +.Oo Ic no Oc Ns Ic sea ) +.It Ic port Ns = Ns Ar value Change the default TCP/UDP name server port to .Ar value . .Pp (Default = 53; abbreviation = .Ic \&po ) -.It Ic querytype= Ns Ar value -.It Ic type= Ns Ar value +.It Ic querytype Ns = Ns Ar value +.It Ic type Ns = Ns Ar value Change the type of information query to one of: .Bl -tag -width "HINFO " .It Dv A @@ -399,15 +401,16 @@ the supported well-known services. .El .Pp Other types -.Pq Dv ANY, AXFR, MB, MD, MF, NULL +.Dv ( ANY , AXFR , MB , +.Dv MD , MF , NULL ) are described in the RFC-1035 document. .Pp (Default = .Dv A ; abbreviations = .Ic q , ty ) -.It Xo Op Ic no -.Ns Ic recurse +.It Xo +.Oo Ic no Oc Ns Ic recurse .Xc Tell the name server to query other servers if it does not have the information. @@ -415,10 +418,8 @@ information. (Default = .Ic recurse ; abbreviation = -.Xo Op Ic no -.Ns Ic rec ) -.Xc -.It Ic retry= Ns Ar number +.Oo Ic no Oc Ns Ic rec ) +.It Ic retry Ns = Ns Ar number Set the number of retries to .Ar number . When a reply to a request is not received within a certain @@ -429,7 +430,7 @@ The retry value controls how many times a request is resent before giving up. .Pp (Default = 4, abbreviation = .Ic ret ) -.It Ic root= Ns Ar host +.It Ic root Ns = Ns Ar host Change the name of the root server to .Ar host . This affects the @@ -440,35 +441,31 @@ command. .Ic ns.internic.net. ; abbreviation = .Ic ro ) -.It Ic timeout= Ns Ar number +.It Ic timeout Ns = Ns Ar number Change the initial timeout interval for waiting for a reply to .Ar number seconds. Each retry doubles the timeout period. .Pp (Default = 5 seconds; abbreviation = .Ic ti ) -.It Xo Op Ic no -.Ns Ic vc +.It Xo +.Oo Ic no Oc Ns Ic vc .Xc Always use a virtual circuit when sending requests to the server. .Pp (Default = .Ic novc ; abbreviation = -.Xo Op Ic no -.Ns Ic v ) +.Oo Ic no Oc Ns Ic v ) +.It Xo +.Oo Ic no Oc Ns Ic ignoretc .Xc -.It Xo Op Ic no -.Ns Ic ignoretc -.Xc Ignore packet truncation errors. .Pp (Default = .Ic noignoretc ; abbreviation = -.Xo Op Ic no -.Ns Ic ig ) -.Xc +.Oo Ic no Oc Ns Ic ig ) .El .El .Sh DIAGNOSTICS @@ -478,9 +475,11 @@ Possible errors are: .It Li Timed out The server did not respond to a request after a certain amount of time (changed with -.Dq Ic set timeout= Ns Ar value ) +.Dq Ic set timeout Ns = Ns Ar value ) and a certain number of retries (changed with -.Dq Ic set retry= Ns Ar value ) . +.Do +.Ic set retry Ns = Ns Ar value +.Dc ) . .It Li \&No response from server No name server is running on the server machine. .It Li \&No records |