[src/trunk]: src/external/mpl/bind/bin/nslookup Remove some obsolete informat...

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

details:   https://anonhg.NetBSD.org/src/rev/3b5b5414c9b1
branches:  trunk
changeset: 953827:3b5b5414c9b1
user:      christos <christos%NetBSD.org@localhost>
date:      Sun Mar 21 16:12:37 2021 +0000

description:
Remove some obsolete information and add some more recent additions from
the nslookup.1 page in the distribution. Consider replacing this man page
with the one from the distribution, since this manual page describes options
available only in the original implemementation. On the other hand, this
man page is mdoc, not man... (Takahiro Kambe)

diffstat:

 external/mpl/bind/bin/nslookup/nslookup.8 |  72 +++++++++++++++++++++---------
 1 files changed, 51 insertions(+), 21 deletions(-)

diffs (179 lines):

diff -r 1135cca0c58e -r 3b5b5414c9b1 external/mpl/bind/bin/nslookup/nslookup.8
--- a/external/mpl/bind/bin/nslookup/nslookup.8 Sun Mar 21 15:44:57 2021 +0000
+++ b/external/mpl/bind/bin/nslookup/nslookup.8 Sun Mar 21 16:12:37 2021 +0000
@@ -1,27 +1,27 @@
-.\"     $NetBSD: nslookup.8,v 1.1 2018/08/12 13:02:26 christos Exp $
+.\"   $NetBSD: nslookup.8,v 1.2 2021/03/21 16:12:37 christos Exp $
 .\"
 .\"
 .\" ++Copyright++ 1985, 1989
 .\" -
 .\" Copyright (c) 1985, 1989
-.\"    The Regents of the University of California.  All rights reserved.
+.\"  The Regents of the University of California. All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
-.\"    notice, this list of conditions and the following disclaimer.
+.\"  notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
-.\"    notice, this list of conditions and the following disclaimer in the
-.\"    documentation and/or other materials provided with the distribution.
+.\"  notice, this list of conditions and the following disclaimer in the
+.\"  documentation and/or other materials provided with the distribution.
 .\" 3. Neither the name of the University nor the names of its contributors
-.\"    may be used to endorse or promote products derived from this software
-.\"    without specific prior written permission.
+.\"  may be used to endorse or promote products derived from this software
+.\"  without specific prior written permission.
 .\"
 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
@@ -41,7 +41,7 @@
 .\"
 .\" THE SOFTWARE IS PROVIDED "AS IS" AND DIGITAL EQUIPMENT CORP. DISCLAIMS ALL
 .\" WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES
-.\" OF MERCHANTABILITY AND FITNESS.   IN NO EVENT SHALL DIGITAL EQUIPMENT
+.\" OF MERCHANTABILITY AND FITNESS.  IN NO EVENT SHALL DIGITAL EQUIPMENT
 .\" CORPORATION BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
 .\" DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
 .\" PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
@@ -52,7 +52,7 @@
 .\"
 .\"    @(#)nslookup.8  5.3 (Berkeley) 6/24/90
 .\"
-.Dd June 24, 1990
+.Dd March 21, 2021
 .Dt NSLOOKUP 8
 .Os
 .Sh NAME
@@ -102,7 +102,7 @@
 For example, to change the default query type to host information,
 and the initial timeout to 10 seconds, type:
 .Bd -literal -offset indent
-       nslookup -query=hinfo  -timeout=10
+       nslookup -query=hinfo -timeout=10
 .Ed
 .Sh INTERACTIVE COMMANDS
 Commands may be interrupted at any time by typing a control-C.
@@ -114,7 +114,7 @@
 To treat a built-in command as a host name,
 precede it with an escape character
 .Pq Sq \e .
-.Em N.B.:  An unrecognized command will be interpreted as a host name.
+.Em N.B.: An unrecognized command will be interpreted as a host name.
 .Bl -tag -width "lserver"
 .It Ar host Op Ar server
 Look up information for
@@ -187,7 +187,7 @@
 The default output contains host names and their Internet addresses.
 .Ar Option
 can be one of the following:
-.Bl -tag -width "-a  "
+.Bl -tag -width "-a "
 .It Fl t Ar querytype
 lists all records of the specified type (see
 .Ar querytype
@@ -229,10 +229,10 @@
 .It Ic all
 Prints the current values of the frequently-used options to
 .Ic set .
-Information about the  current default server and host is also printed.
+Information about the current default server and host is also printed.
 .It Ic class Ns = Ns Ar value
 Change the query class to one of:
-.Bl -tag -width "HESIOD  "
+.Bl -tag -width "HESIOD "
 .It Dv IN
 the Internet class
 .It Dv CHAOS
@@ -350,7 +350,7 @@
 .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   "
+.Bl -tag -width "HINFO  "
 .It Dv A
 the host's Internet address.
 .It Dv CNAME
@@ -406,6 +406,10 @@
 .Pp
 (Default = 4, abbreviation =
 .Ic ret )
+.It Ic ndots Ns = Ns Ar number
+This keyword sets the number of dots (label separators)
+in a domain that disables searching.
+Absolute names always stop searching.
 .It Ic root Ns = Ns Ar host
 Change the name of the root server to
 .Ar host .
@@ -439,23 +443,48 @@
 .Ic noignoretc ;
 abbreviation =
 .Oo Ic no Oc Ns Ic ig )
+.It Oo Ic no Oc Ns Ic fail
+This  keyword  tries  the next nameserver if a nameserver responds
+with 
+.Dv SERVFAIL
+or a referral (nofail), or terminates the query
+(fail) on such a response.
+.Pp
+The default is nofail.
 .El
 .El
+.Sh RETURN VALUES
+.Nm
+returns with an exit status of
+.Dv 1
+if any query failed, and
+.Dv 0
+otherwise.
+.Sh IDN SUPPORT
+If 
+.Nm
+has been built with IDN (internationalized domain name)
+support, it can accept and display non-ASCII domain names.
+.Nm 
+appropriately converts character encoding of a domain name before sending
+a request to a DNS server or displaying a reply from the server.
+To turn off IDN support, define the IDN_DISABLE environment variable.
+IDN support is disabled if the variable is set when
+.Nm 
+runs, or when the standard output is not a tty.
 .Sh ENVIRONMENT
 .Bl -tag -width "HOSTALIASESXXXX" -compact
 .It Ev HOSTALIASES
 file containing host aliases
 .It Ev LOCALDOMAIN
 overrides default domain
+.It Ev IDN_DISABLE
+turns off IDN support
 .El
 .Sh FILES
-.Bl -tag -width "/usr/share/misc/nslookup.helpXXX" -compact
+.Bl -tag -width "/etc/resolve.conf" -compact
 .It Pa /etc/resolv.conf
 initial domain name and name server addresses
-.It Pa $HOME/.nslookuprc
-user's initial options
-.It Pa /usr/share/misc/nslookup.help
-summary of commands
 .El
 .Sh DIAGNOSTICS
 If the lookup request was not successful, an error message is printed.
@@ -499,6 +528,7 @@
 .Nm nslookup .
 .El
 .Sh SEE ALSO
+.Xr dig 1 ,
 .Xr resolver 3 ,
 .Xr resolv.conf 5 ,
 .Xr named 8