From 3241ddcf9354c5ab50f4df5a656e72a5c68e172b Mon Sep 17 00:00:00 2001 From: Tinderbox User Date: Sat, 30 Apr 2016 01:05:59 +0000 Subject: [PATCH] regen master --- bin/dig/host.1 | 264 ++++++++++++++----------- bin/dig/host.html | 328 +++++++++++++++++-------------- doc/arm/Bv9ARM.ch09.html | 28 +++ doc/arm/man.dnssec-coverage.html | 40 ++-- doc/arm/man.host.html | 326 ++++++++++++++++-------------- doc/arm/notes.html | 28 +++ 6 files changed, 589 insertions(+), 425 deletions(-) diff --git a/bin/dig/host.1 b/bin/dig/host.1 index 9b15943fa3..d6baf9236f 100644 --- a/bin/dig/host.1 +++ b/bin/dig/host.1 @@ -1,4 +1,4 @@ -.\" Copyright (C) 2004, 2005, 2007-2009, 2014, 2015 Internet Systems Consortium, Inc. ("ISC") +.\" Copyright (C) 2004, 2005, 2007-2009, 2014-2016 Internet Systems Consortium, Inc. ("ISC") .\" Copyright (C) 2000-2002 Internet Software Consortium. .\" .\" Permission to use, copy, modify, and/or distribute this software for any @@ -65,59 +65,74 @@ is an optional argument which is either the name or IP address of the name serve \fBhost\fR should query instead of the server or servers listed in /etc/resolv\&.conf\&. +.SH "OPTIONS" .PP -The +\-4 +.RS 4 +Use IPv4 only for query transport\&. See also the +\fB\-6\fR +option\&. +.RE +.PP +\-6 +.RS 4 +Use IPv6 only for query transport\&. See also the +\fB\-4\fR +option\&. +.RE +.PP +\-a +.RS 4 +"All"\&. The \fB\-a\fR -(all) option is equivalent to setting the -\fB\-v\fR -option and asking -\fBhost\fR -to make a query of type ANY\&. +option is normally equivalent to +\fB\-v\fR\fB\-t\fRANY\&. It also affects the behaviour of the +\fB\-l\fR +list zone option\&. +.RE .PP -When the -\fB\-C\fR -option is used, +\-c \fIclass\fR +.RS 4 +Query class: This can be used to lookup Hesiod or Chaosnet class resource records\&. The default class is IN (Internet)\&. +.RE +.PP +\-C +.RS 4 +Check consistency: \fBhost\fR -will attempt to display the SOA records for zone +will query the SOA records for zone \fIname\fR from all the listed authoritative name servers for that zone\&. The list of name servers is defined by the NS records that are found for the zone\&. +.RE .PP -The -\fB\-c\fR -option instructs to make a DNS query of class -\fIclass\fR\&. This can be used to lookup Hesiod or Chaosnet class resource records\&. The default class is IN (Internet)\&. -.PP -Verbose output is generated by -\fBhost\fR -when the -\fB\-d\fR -or +\-d +.RS 4 +Print debugging traces\&. Equivalent to the \fB\-v\fR -option is used\&. The two options are equivalent\&. They have been provided for backwards compatibility\&. In previous versions, the -\fB\-d\fR -option switched on debugging traces and -\fB\-v\fR -enabled verbose output\&. Verbose output can also be enabled by setting the -\fIdebug\fR -option in -/etc/resolv\&.conf\&. +verbose option\&. +.RE .PP -List mode is selected by the -\fB\-l\fR -option\&. This makes +\-i +.RS 4 +Obsolete\&. Use the IP6\&.INT domain for reverse lookups of IPv6 addresses as defined in RFC1886 and deprecated in RFC4159\&. The default is to use IP6\&.ARPA as specified in RFC3596\&. +.RE +.PP +\-l +.RS 4 +List zone: The \fBhost\fR -perform a zone transfer for zone -\fIname\fR\&. Transfer the zone printing out the NS, PTR and address records (A/AAAA)\&. If combined with -\fB\-a\fR -all records will be printed\&. +performs a zone transfer of zone +\fIname\fR +and prints out the NS, PTR and address records (A/AAAA)\&. +.sp +Together, the +\fB\-l\fR\fB\-a\fR +options print all records in the zone\&. +.RE .PP -The -\fB\-i\fR -option specifies that reverse lookups of IPv6 addresses should use the IP6\&.INT domain as defined in RFC1886\&. The default is to use IP6\&.ARPA\&. -.PP -The -\fB\-N\fR -option sets the number of dots that have to be in +\-N \fIndots\fR +.RS 4 +The number of dots that have to be in \fIname\fR for it to be considered absolute\&. The default value is that defined using the ndots statement in /etc/resolv\&.conf, or 1 if no ndots statement is present\&. Names with fewer dots are interpreted as relative names and will be searched for in the domains listed in the @@ -126,105 +141,116 @@ or \fBdomain\fR directive in /etc/resolv\&.conf\&. +.RE .PP -The number of UDP retries for a lookup can be changed with the -\fB\-R\fR -option\&. -\fInumber\fR -indicates how many times +\-r +.RS 4 +Non\-recursive query: Setting this option clears the +\fBRD\fR +\(em recursion desired \(em bit in the query\&. This should mean that the name server receiving the query will not attempt to resolve +\fIname\fR\&. The +\fB\-r\fR +option enables \fBhost\fR -will repeat a query that does not get answered\&. If +to mimic the behavior of a name server by making non\-recursive queries and expecting to receive answers to those queries that can be referrals to other name servers\&. +.RE +.PP +\-R \fInumber\fR +.RS 4 +Number of retries for UDP queries: If \fInumber\fR is negative or zero, the number of retries will default to 1\&. The default value is 1, or the value of the \fIattempts\fR option in /etc/resolv\&.conf, if set\&. +.RE .PP -Non\-recursive queries can be made via the -\fB\-r\fR -option\&. Setting this option clears the -\fBRD\fR -\(em recursion desired \(em bit in the query which -\fBhost\fR -makes\&. This should mean that the name server receiving the query will not attempt to resolve -\fIname\fR\&. The -\fB\-r\fR -option enables -\fBhost\fR -to mimic the behavior of a name server by making non\-recursive queries and expecting to receive answers to those queries that are usually referrals to other name servers\&. +\-s +.RS 4 +Do +\fInot\fR +send the query to the next nameserver if any server responds with a SERVFAIL response, which is the reverse of normal stub resolver behavior\&. +.RE .PP -By default, +\-t \fItype\fR +.RS 4 +Query type: the +\fItype\fR +argument can be any recognized query type: CNAME, NS, SOA, TXT, DNSKEY, AXFR, etc\&. +.sp +When no query type is specified, +\fBhost\fR +automatically selects an appropriate query type\&. By default, it looks for A, AAAA, and MX records\&. If the +\fB\-C\fR +option is given, queries will be made for SOA records\&. If +\fIname\fR +is a dotted\-decimal IPv4 address or colon\-delimited IPv6 address, +\fBhost\fR +will query for PTR records\&. +.sp +If a query type of IXFR is chosen the starting serial number can be specified by appending an equal followed by the starting serial number (e\&.g\&. +\fB\-t\fRIXFR=12345678)\&. +.RE +.PP +\-T +.RS 4 +TCP: By default, \fBhost\fR uses UDP when making queries\&. The \fB\-T\fR option makes it use a TCP connection when querying the name server\&. TCP will be automatically selected for queries that require it, such as zone transfer (AXFR) requests\&. +.RE .PP -The -\fB\-4\fR -option forces -\fBhost\fR -to only use IPv4 query transport\&. The -\fB\-6\fR -option forces -\fBhost\fR -to only use IPv6 query transport\&. +\-m \fIflag\fR +.RS 4 +Memory usage debugging: the flag can be +\fIrecord\fR, +\fIusage\fR, or +\fItrace\fR\&. You can specify the +\fB\-m\fR +option more than once to set multiple flags\&. +.RE .PP -The -\fB\-t\fR -option is used to select the query type\&. -\fItype\fR -can be any recognized query type: CNAME, NS, SOA, SIG, KEY, AXFR, etc\&. When no query type is specified, -\fBhost\fR -automatically selects an appropriate query type\&. By default, it looks for A, AAAA, and MX records, but if the -\fB\-C\fR -option was given, queries will be made for SOA records, and if -\fIname\fR -is a dotted\-decimal IPv4 address or colon\-delimited IPv6 address, -\fBhost\fR -will query for PTR records\&. If a query type of IXFR is chosen the starting serial number can be specified by appending an equal followed by the starting serial number (e\&.g\&. \-t IXFR=12345678)\&. +\-v +.RS 4 +Verbose output\&. Equivalent to the +\fB\-d\fR +debug option\&. Verbose output can also be enabled by setting the +\fIdebug\fR +option in/etc/resolv\&.conf\&. +.RE .PP -The time to wait for a reply can be controlled through the +\-V +.RS 4 +Print the version number and exit\&. +.RE +.PP +\-w +.RS 4 +Wait forever: the query timeout is set to the maximum possible\&. See also the \fB\-W\fR -and -\fB\-w\fR -options\&. The -\fB\-W\fR -option makes -\fBhost\fR -wait for +option\&. +.RE +.PP +\-W \fIwait\fR +.RS 4 +Timeout: wait for up to \fIwait\fR -seconds\&. If +seconds for a reply\&. If \fIwait\fR -is less than one, the wait interval is set to one second\&. When the -\fB\-w\fR -option is used, -\fBhost\fR -will effectively wait forever for a reply\&. The time to wait for a response will be set to the number of seconds given by the hardware\*(Aqs maximum value for an integer quantity\&. By default, +is less than one, the wait interval is set to one second\&. +.sp +By default, \fBhost\fR will wait for 5 seconds for UDP responses and 10 seconds for TCP connections\&. These defaults can be overridden by the \fItimeout\fR option in /etc/resolv\&.conf\&. -.PP -The -\fB\-s\fR -option tells -\fBhost\fR\fInot\fR -to send the query to the next nameserver if any server responds with a SERVFAIL response, which is the reverse of normal stub resolver behavior\&. -.PP -The -\fB\-m\fR -can be used to set the memory usage debugging flags -\fIrecord\fR, -\fIusage\fR -and -\fItrace\fR\&. -.PP -The -\fB\-V\fR -option causes -\fBhost\fR -to print the version number and exit\&. +.sp +See also the +\fB\-w\fR +option\&. +.RE .SH "IDN SUPPORT" .PP If @@ -248,7 +274,7 @@ runs\&. \fBInternet Systems Consortium, Inc\&.\fR .SH "COPYRIGHT" .br -Copyright \(co 2004, 2005, 2007-2009, 2014, 2015 Internet Systems Consortium, Inc. ("ISC") +Copyright \(co 2004, 2005, 2007-2009, 2014-2016 Internet Systems Consortium, Inc. ("ISC") .br Copyright \(co 2000-2002 Internet Software Consortium. .br diff --git a/bin/dig/host.html b/bin/dig/host.html index b9d8d69ba6..98ede811b3 100644 --- a/bin/dig/host.html +++ b/bin/dig/host.html @@ -1,5 +1,5 @@