summaryrefslogtreecommitdiffstats
path: root/contrib/bind
diff options
context:
space:
mode:
authornectar <nectar@FreeBSD.org>2002-05-13 19:35:44 +0000
committernectar <nectar@FreeBSD.org>2002-05-13 19:35:44 +0000
commit85aae18cf4da9dbc5e850d30f1bbe0fcc970d6e8 (patch)
tree9a3345ec734bbe41cf8850029b794fe7ff21c26a /contrib/bind
parentf061e4498911e789b1489759f101997fbe736702 (diff)
downloadFreeBSD-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')
-rw-r--r--contrib/bind/doc/man/dig.129
-rw-r--r--contrib/bind/doc/man/host.114
-rw-r--r--contrib/bind/doc/man/nslookup.899
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
OpenPOWER on IntegriCloud