[src/netbsd-1-6]: src/dist/bind/man Pull up revisions 1.6-1.7 (requested by i...

[lukem <lukem%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/2b81a77aae8e
branches:  netbsd-1-6
changeset: 528251:2b81a77aae8e
user:      lukem <lukem%NetBSD.org@localhost>
date:      Fri Jun 28 12:00:22 2002 +0000

description:
Pull up revisions 1.6-1.7 (requested by itojun in ticket #387):
Update to BIND 8.3.3.  Fixes buffer overrun in resolver code.

diffstat:

 dist/bind/man/nslookup.8 |  108 +++++++++++++++++++++-------------------------
 1 files changed, 50 insertions(+), 58 deletions(-)

diffs (261 lines):

diff -r e199972dc872 -r 2b81a77aae8e dist/bind/man/nslookup.8
--- a/dist/bind/man/nslookup.8  Fri Jun 28 12:00:13 2002 +0000
+++ b/dist/bind/man/nslookup.8  Fri Jun 28 12:00:22 2002 +0000
@@ -1,4 +1,4 @@
-.\"     $NetBSD: nslookup.8,v 1.5 2001/06/05 12:49:36 wiz Exp $
+.\"     $NetBSD: nslookup.8,v 1.5.2.1 2002/06/28 12:00:22 lukem Exp $
 .\"
 .\"
 .\" ++Copyright++ 1985, 1989
@@ -172,7 +172,7 @@
 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 @@
 command(s) with 
 .Xr more 1 .
 .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 @@
 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 @@
 .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 @@
 (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 @@
 .Xr hostname 1 , 
 .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 @@
 .Xr hostname 1 , 
 .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 @@
 (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 @@
 (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 @@
 .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 @@
 (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 @@
 .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 @@
 .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 @@
 .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
@@ -536,10 +535,3 @@
 .Dq Domain Names - Implementation and Specification .
 .Sh AUTHOR
 Andrew Cherenson
-.Sh BUGS
-.Nm
-does not support DNS queries/replies over IPv6 transport, and ignores
-IPv6 address on
-.Dq nameserver
-line in
-.Xr resolv.conf 5 .