diff options
author | David E. O'Brien <obrien@FreeBSD.org> | 2000-01-02 11:13:23 +0000 |
---|---|---|
committer | David E. O'Brien <obrien@FreeBSD.org> | 2000-01-02 11:13:23 +0000 |
commit | 8a579d74bf6234385e47f70a064cb8509560e8df (patch) | |
tree | bf92dcef22ea4091152e81708759385818f835d4 /contrib/bind/doc | |
parent | 70852092e86fde3521dd31dfde9da80994087aab (diff) | |
download | src-8a579d74bf6234385e47f70a064cb8509560e8df.tar.gz src-8a579d74bf6234385e47f70a064cb8509560e8df.zip |
Since this has left the vendor branch, sort this incredably disorganized
manpage.
Notes
Notes:
svn path=/head/; revision=55309
Diffstat (limited to 'contrib/bind/doc')
-rw-r--r-- | contrib/bind/doc/man/host.1 | 108 |
1 files changed, 55 insertions, 53 deletions
diff --git a/contrib/bind/doc/man/host.1 b/contrib/bind/doc/man/host.1 index 9ae7d6c78069..89611e4823fc 100644 --- a/contrib/bind/doc/man/host.1 +++ b/contrib/bind/doc/man/host.1 @@ -51,6 +51,8 @@ .\" - .\" --Copyright-- .\" $Id: host.1,v 8.2 1997/03/14 02:29:44 vixie Exp $ +.\" $FreeBSD$ +.\" .Dd December 15, 1994 .Dt HOST @CMD_EXT_U@ .Os BSD 4 @@ -59,13 +61,9 @@ .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 adlrwv +.Op Fl c Ar class .Op Fl t Ar querytype -.Op Fl a .Ar host .Op Ar server .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 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 @INDOT@named @SYS_OPS_EXT@ . -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 a +.Dq all ; +this is equivalent to +.Dq Fl v Fl t Cm any . +.It Fl c Ar class +The +.Ar class +to look for non-Internet data. +.It Fl d +Turn on debugging. Network transactions are shown in detail. +.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 +that you have asked for. This command should be used only if it +is absolutely necessary. .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 @@ -227,34 +239,24 @@ 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 -that you have asked for. This command should be used only if it -is absolutely necessary. +option for more information. +.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 @INDOT@named @SYS_OPS_EXT@ . +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 w +This causes +.Ic host +to wait forever for a response. Normally +it will time out after approximate one minute. .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. |