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

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

details:   https://anonhg.NetBSD.org/src/rev/73d22b4202b8
branches:  netbsd-1-6
changeset: 528243:73d22b4202b8
user:      lukem <lukem%NetBSD.org@localhost>
date:      Fri Jun 28 11:58:58 2002 +0000

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

diffstat:

 dist/bind/man/dig.1 |  52 +++++++++++++++++++++++++++++++++-------------------
 1 files changed, 33 insertions(+), 19 deletions(-)

diffs (139 lines):

diff -r 629f0de635db -r 73d22b4202b8 dist/bind/man/dig.1
--- a/dist/bind/man/dig.1       Fri Jun 28 11:58:40 2002 +0000
+++ b/dist/bind/man/dig.1       Fri Jun 28 11:58:58 2002 +0000
@@ -1,6 +1,6 @@
-.\"     $NetBSD: dig.1,v 1.3 2001/06/05 10:08:04 wiz Exp $
+.\"     $NetBSD: dig.1,v 1.3.2.1 2002/06/28 11:58:58 lukem Exp $
 .\"
-.\" Id: dig.1,v 8.4 1999/10/15 21:29:58 vixie Exp
+.\" Id: dig.1,v 8.9 2002/06/18 01:53:43 marka Exp
 .\"
 .\" ++Copyright++ 1993
 .\" -
@@ -97,12 +97,12 @@
 where:
 .Bl -tag -width Fl
 .It Ar server
-may be either a domain name or a dot-notation
+may be either a domain name or a raw (IPv4 / IPv6)
 Internet address. If this optional field is omitted, 
 .Ic dig
 will attempt to use the default name server for your machine.
 .sp 1
-.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 
@@ -118,7 +118,7 @@
 .Xr resolver 5
 for information on 
 .Pa /etc/resolv.conf .
-.Sy WARNING: 
+.Sy WARNING :
 Changing 
 .Pa /etc/resolv.conf 
 will affect both the standard resolver library and 
@@ -147,7 +147,7 @@
 .Fl x 
 option (documented in the
 .Sx OTHER OPTIONS 
-subsection of this section) for convenient way to specify inverse address
+subsection of this section) for convenient way to specify reverse address
 query.
 .It Ar query-type
 is the type of information (DNS query type) that
@@ -192,7 +192,7 @@
 .Pp
 (See RFC 1035 for the complete list.)
 .Pp
-.Em Note:
+.Em Note :
 .Dq Ar Any
 can be used to specify a 
 .Em class 
@@ -242,9 +242,15 @@
 .It Fl x Ar dot-notation-address
 Convenient form to specify inverse address mapping.
 Instead of 
-.Dq Ic dig 32.0.9.128.in-addr.arpa , 
+.Dq Ic dig 32.0.9.28.in-addr.arpa , 
 one can simply 
-.Dq Ic dig -x 128.9.0.32 .
+.Dq Ic dig -x 28.9.0.32 .
+.It Fl x Ar IPv6-address
+Convenient form to specify inverse address mapping.
+Instead of 
+.Dq Ic dig 1.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.ip6.arpa ,
+one can simply 
+.Dq Ic dig -x ::1 .
 .It Fl f Ar file
 File for 
 .Ic dig
@@ -325,7 +331,7 @@
 .Dq Pa DiG.env 
 is created in the current working directory.
 .Pp
-.Em Note: 
+.Em Note :
 .Ev LOCALDEF 
 is specific to the 
 .Ic dig
@@ -523,6 +529,13 @@
 .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 
@@ -568,6 +581,13 @@
 .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 
@@ -643,7 +663,7 @@
 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
@@ -674,7 +694,8 @@
 .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
@@ -683,10 +704,3 @@
 .Ic dig
 simply
 continues with the next query.
-.Pp
-.Nm
-does not support DNS queries/replies over IPv6 transport, and ignores
-IPv6 address on
-.Dq nameserver
-line in
-.Xr resolv.conf 5 .