[src/netbsd-1-4]: src/dist/bind/man Pull up revisions 1.1-1.2 (new) (requeste...

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

details:   https://anonhg.NetBSD.org/src/rev/983d6dd4c166
branches:  netbsd-1-4
changeset: 469810:983d6dd4c166
user:      he <he%NetBSD.org@localhost>
date:      Sat Dec 04 17:10:03 1999 +0000

description:
Pull up revisions 1.1-1.2 (new) (requested by christos and veego):
  Update to BIND 8.2.2-P5.

diffstat:

 dist/bind/man/host.1 |  319 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 319 insertions(+), 0 deletions(-)

diffs (truncated from 323 to 300 lines):

diff -r 05c60262c6ba -r 983d6dd4c166 dist/bind/man/host.1
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/dist/bind/man/host.1      Sat Dec 04 17:10:03 1999 +0000
@@ -0,0 +1,319 @@
+.\"     $NetBSD: host.1,v 1.2.2.2 1999/12/04 17:10:03 he Exp $
+.\"
+.\" ++Copyright++ 1993
+.\" -
+.\" Copyright (c) 1993
+.\"    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.
+.\" 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.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. 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.
+.\" 
+.\" 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
+.\" 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)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\" -
+.\" Portions Copyright (c) 1993 by Digital Equipment Corporation.
+.\" 
+.\" Permission to use, copy, modify, and distribute this software for any
+.\" purpose with or without fee is hereby granted, provided that the above
+.\" copyright notice and this permission notice appear in all copies, and that
+.\" the name of Digital Equipment Corporation not be used in advertising or
+.\" publicity pertaining to distribution of the document or software without
+.\" specific, written prior permission.
+.\" 
+.\" 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
+.\" 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
+.\" ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
+.\" SOFTWARE.
+.\" -
+.\" --Copyright--
+.\" Id: host.1,v 8.2 1997/03/14 02:29:44 vixie Exp
+.Dd December 15, 1994
+.Dt HOST 1
+.Os BSD 4
+.Sh NAME
+.Nm host 
+.Nd look up host names using domain server
+.Sh SYNOPSIS 
+.Nm host 
+.Op Fl l
+.Op Fl v
+.Op Fl w
+.Op Fl r
+.Op Fl d
+.Op Fl t Ar querytype
+.Op Fl a 
+.Ar host 
+.Op Ar server 
+.Sh DESCRIPTION 
+.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
+Internet addresses.  However, with the 
+.Dq Fl t 
+or 
+.Dq Fl a 
+options, it can be used
+to find all of the information about this host that is maintained
+by the domain server.
+.Pp
+The arguments can be either host names or host numbers.  The program
+first attempts to interpret them as host numbers.  If this fails,
+it will treat them as host names.  A host number consists of
+first decimal numbers separated by dots, e.g. 128.6.4.194
+A host name consists of names separated by dots, e.g. topaz.rutgers.edu.  
+Unless the name ends in a dot, the local domain
+is automatically tacked on the end.  Thus, a Rutgers user can say
+.Pp
+.D1 Ic host topaz 
+.Pp
+and it will actually look up "topaz.rutgers.edu".
+If this fails, the name is tried unchanged (in this case, "topaz").
+This same convention is used for mail and other network utilities.
+The actual suffix to tack on the end is obtained
+by looking at the results of a 
+.Xr hostname 1
+call, and using everything
+starting at the first dot.  (See below for a description of
+.Sx CUSTOMIZING HOST NAME LOOKUP . )
+.Pp
+The first argument is the host name you want to look up.
+If this is a number, an 
+.Dq inverse query 
+is done, i.e. the domain
+system looks in a separate set of databases used to convert numbers
+to names.
+.Pp
+The second argument is optional.  It
+allows you to specify a particular server to query.  If you don't
+specify this argument, the default server (normally the local machine)
+is used.
+.Pp
+If a name is specified, you may see output of three different kinds.
+Here is an example that shows all of them:
+.Pp
+.D1 Ic % host sun4
+.Dl sun4.rutgers.edu is a nickname for ATHOS.RUTGERS.EDU
+.Dl ATHOS.RUTGERS.EDU has address 128.6.5.46
+.Dl ATHOS.RUTGERS.EDU has address 128.6.4.4
+.Dl ATHOS.RUTGERS.EDU mail is handled by ARAMIS.RUTGERS.EDU
+.Pp
+The user has typed the command 
+.Dq Ic host sun4 .  
+The first line indicates that the name 
+.Dq Li sun4.rutgers.edu 
+is actually a nickname.  The official host name is 
+.Dq Li ATHOS.RUTGERS.EDU .  
+The next two lines show the
+address.  If a system has more than one network interface, there
+will be a separate address for each.  The last line indicates
+that 
+.Li ATHOS.RUTGERS.EDU 
+does not receive its own mail.  Mail for
+it is taken by 
+.Li ARAMIS.RUTGERS.EDU .  
+There may be more than one
+such line, since some systems have more than one other system
+that will handle mail for them.  Technically, every system that
+can receive mail is supposed to have an entry of this kind.  If
+the system receives its own mail, there should be an entry
+the mentions the system itself; for example,
+.Pp
+.D1 Li XXX mail is handled by XXX 
+.Pp
+However, many systems that receive
+their own mail do not bother to mention that fact.  If a system
+has a 
+.Dq Li mail is handled by 
+entry, but no address, this indicates
+that it is not really part of the Internet, but a system that is
+on the network will forward mail to it.  Systems on Usenet, Bitnet,
+and a number of other networks have entries of this kind.
+.Sh OPTIONS
+There are a number of options that can be used before the
+host name.  Most of these options are meaningful only to the
+staff who have to maintain the domain database.
+.Bl -tag -width Fl
+.It Fl w 
+This causes 
+.Ic host 
+to wait forever for a response.  Normally
+it will time out after approximate one minute.
+.It Fl v
+Use "verbose" format for printout.  This
+is the official domain master file format, which is documented 
+in the man page for 
+.Xr named 8 .
+Without this option, output still follows
+this format in general terms, but some attempt is made to make it
+more intelligible to normal users.  Without 
+.Dq Fl v ,
+any "a", "mx", and "cname" records
+are written out as "has address", "mail is handled by", and
+"is a nickname for" (respectively), and TTL and class fields are not shown.
+.It Fl r
+Turn off recursion in the request.
+This means that the name server will return only data it has in
+its own database.  It will not ask other servers for more 
+information.
+.It Fl d
+Turn on debugging.  Network transactions are shown in detail.
+.It Fl t Ar querytype
+Allows you to specify a particular 
+.Ar querytype 
+of information
+to be looked up.  The arguments are defined in the man page for
+.Xr named 8 .
+Currently-supported types include: 
+.Dq Cm a , 
+.Dq Cm ns , 
+.Dq Cm md , 
+.Dq Cm mf , 
+.Dq Cm cname ,
+.Dq Cm soa , 
+.Dq Cm mb , 
+.Dq Cm mg , 
+.Dq Cm mr , 
+.Dq Cm null , 
+.Dq Cm wks , 
+.Dq Cm ptr , 
+.Dq Cm hinfo , 
+.Dq Cm minfo , 
+.Dq Cm mx , 
+.Dq Cm uinfo ,
+.Dq Cm uid , 
+.Dq Cm gid , 
+.Dq Cm unspec .  
+Additionally, the wildcard, which may be written
+as either 
+.Dq Cm any 
+or 
+.Dq Cm * ,
+can be used to specify any (all) of the above types.  
+Types must be given in lower case.
+Note that the default is to look first for 
+.Dq Cm a , 
+and then 
+.Dq Cm mx , 
+except that if the verbose option is turned on, the default is only 
+.Dq Cm a .
+The
+.Dq Fl t
+option is particularly useful for filtering information returned by 
+.Ic host ;
+see the explanation of the
+.Dq Fl l
+option, below, for more information.
+.It Fl a 
+.Dq all ;
+this is equivalent to 
+.Dq Fl v Fl t Cm any .
+.It Fl l
+List a complete domain; e.g.:
+.Pp
+.D1 Ic host -l rutgers.edu
+.Pp
+will give a listing of all hosts in the rutgers.edu domain.  The 
+.Dq Fl t
+option is used to filter what information is presented, as you 
+would expect.  The default is address information, which also
+include PTR and NS records.  The command
+.Pp
+.D1 Ic host -l -v -t any rutgers.edu
+.Pp
+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: 
+.Dq Fl l 
+is implemented by
+doing a complete zone transfer and then filtering out the information
+the you have asked for.  This command should be used only if it
+is absolutely necessary.
+.El
+.Sh CUSTOMIZING HOST NAME LOOKUP
+In general, if the name supplied by the user does not
+have any dots in it, a default domain is appended to the end.
+This domain can be defined in 
+.Pa /etc/resolv.conf , 
+but is normally derived
+by taking the local hostname after its first dot.  The user can override
+this, and specify a different default domain, using the environment
+variable
+.Ev LOCALDOMAIN .
+In addition, the user can supply his own abbreviations for host names.
+They should be in a file consisting of one line per abbreviation.
+Each line contains an abbreviation, a space, and then the full
+host name.  The name file must be contained in the 
+.Ev HOSTALIASES 
+environment variable.
+.Sh ENVIRONMENT
+.Bl -tag -width "/etc/resolv.conf  " -compress
+.It Ev HOSTALIASES
+Name of file containing
+.Pq Ar host alias , full hostname
+pairs.
+.El
+.Sh FILES
+.Bl -tag -width "/etc/resolv.conf  " -compress
+.It Pa /etc/resolv.conf 
+See
+.Xr resolver 5 .
+.It Ev HOSTALIASES
+Name of file containing
+.Pq Ar host alias , full hostname
+pairs.
+.El
+.Sh SEE ALSO
+.Xr named  8 , 
+.Xr resolver 5 .