d/freebsd-nq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Since this has left the vendor branch, sort this incredably disorganized

Browse Source 
manpage.
This commit is contained in:
David E. O'Brien 2000-01-02 11:13:23 +00:00
parent 70852092e8
commit 8a579d74bf
1 changed files with 55 additions and 53 deletions

108
contrib/bind/doc/man/host.1

@ -51,6 +51,8 @@
.\" - .\" -
.\" --Copyright-- .\" --Copyright--
.\" $Id: host.1,v 8.2 1997/03/14 02:29:44 vixie Exp $ .\" $Id: host.1,v 8.2 1997/03/14 02:29:44 vixie Exp $
.\" $FreeBSD$
.\"
.Dd December 15, 1994 .Dd December 15, 1994
.Dt HOST @CMD_EXT_U@ .Dt HOST @CMD_EXT_U@
.Os BSD 4 .Os BSD 4
@ -59,13 +61,9 @@
.Nd look up host names using domain server .Nd look up host names using domain server
.Sh SYNOPSIS .Sh SYNOPSIS
.Nm host .Nm host
.Op Fl l .Op Fl adlrwv
.Op Fl v .Op Fl c Ar class
.Op Fl w
.Op Fl r
.Op Fl d
.Op Fl t Ar querytype .Op Fl t Ar querytype
.Op Fl a
.Ar host .Ar host
.Op Ar server .Op Ar server
.Sh DESCRIPTION .Sh DESCRIPTION
@ -158,30 +156,44 @@ There are a number of options that can be used before the
host name. Most of these options are meaningful only to the host name. Most of these options are meaningful only to the
staff who have to maintain the domain database. staff who have to maintain the domain database.
.Bl -tag -width Fl .Bl -tag -width Fl
.It Fl w .It Fl a
This causes .Dq all ;
.Ic host this is equivalent to
to wait forever for a response. Normally .Dq Fl v Fl t Cm any .
it will time out after approximate one minute. .It Fl c Ar class
.It Fl v The
Use "verbose" format for printout. This .Ar class
is the official domain master file format, which is documented to look for non-Internet data.
in the man page for .It Fl d
.Xr @INDOT@named @SYS_OPS_EXT@ . Turn on debugging. Network transactions are shown in detail.
Without this option, output still follows .It Fl l
this format in general terms, but some attempt is made to make it List a complete domain; e.g.:
more intelligible to normal users. Without .Pp
.Dq Fl v , .D1 Ic host -l rutgers.edu
any "a", "mx", and "cname" records .Pp
are written out as "has address", "mail is handled by", and will give a listing of all hosts in the rutgers.edu domain. The
"is a nickname for" (respectively), and TTL and class fields are not shown. .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
that you have asked for. This command should be used only if it
is absolutely necessary.
.It Fl r .It Fl r
Turn off recursion in the request. Turn off recursion in the request.
This means that the name server will return only data it has in This means that the name server will return only data it has in
its own database. It will not ask other servers for more its own database. It will not ask other servers for more
information. information.
.It Fl d
Turn on debugging. Network transactions are shown in detail.
.It Fl t Ar querytype .It Fl t Ar querytype
Allows you to specify a particular Allows you to specify a particular
.Ar querytype .Ar querytype
@ -227,34 +239,24 @@ option is particularly useful for filtering information returned by
.Ic host ; .Ic host ;
see the explanation of the see the explanation of the
.Dq Fl l .Dq Fl l
option, below, for more information. option for more information.
.It Fl a .It Fl v
.Dq all ; Use "verbose" format for printout. This
this is equivalent to is the official domain master file format, which is documented
.Dq Fl v Fl t Cm any . in the man page for
.It Fl l .Xr @INDOT@named @SYS_OPS_EXT@ .
List a complete domain; e.g.: Without this option, output still follows
.Pp this format in general terms, but some attempt is made to make it
.D1 Ic host -l rutgers.edu more intelligible to normal users. Without
.Pp .Dq Fl v ,
will give a listing of all hosts in the rutgers.edu domain. The any "a", "mx", and "cname" records
.Dq Fl t are written out as "has address", "mail is handled by", and
option is used to filter what information is presented, as you "is a nickname for" (respectively), and TTL and class fields are not shown.
would expect. The default is address information, which also .It Fl w
include PTR and NS records. The command This causes
.Pp .Ic host
.D1 Ic host -l -v -t any rutgers.edu to wait forever for a response. Normally
.Pp it will time out after approximate one minute.
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
that you have asked for. This command should be used only if it
is absolutely necessary.
.Sh CUSTOMIZING HOST NAME LOOKUP .Sh CUSTOMIZING HOST NAME LOOKUP
In general, if the name supplied by the user does not In general, if the name supplied by the user does not
have any dots in it, a default domain is appended to the end. have any dots in it, a default domain is appended to the end.