From 364712b4951f916e240183e735e7969ef5cb87c0 Mon Sep 17 00:00:00 2001 From: Tinderbox User Date: Sat, 30 Apr 2016 01:11:02 +0000 Subject: [PATCH] regen v9_10 --- bin/dig/host.1 | 263 ++++++++++++++------------ bin/dig/host.html | 313 +++++++++++++++++-------------- bin/python/dnssec-coverage.8 | 22 ++- bin/python/dnssec-coverage.html | 42 +++-- doc/arm/man.dnssec-coverage.html | 40 ++-- doc/arm/man.host.html | 311 ++++++++++++++++-------------- 6 files changed, 559 insertions(+), 432 deletions(-) diff --git a/bin/dig/host.1 b/bin/dig/host.1 index f654d97763..20e27b6031 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,56 +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 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 @@ -123,97 +141,108 @@ 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 -\fBhost\fR -will repeat a query that does not get answered\&. The default number of retries is 1\&. If -\fInumber\fR -is negative or zero, the number of retries will default to 1\&. -.PP -Non\-recursive queries can be made via the -\fB\-r\fR -option\&. Setting this option clears the +\-r +.RS 4 +Non\-recursive query: 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 +\(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 -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\&. +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 -By default, +\-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\&. +.RE +.PP +\-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 +\-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\&. -.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)\&. -.PP -The time to wait for a reply can be controlled through the -\fB\-W\fR -and -\fB\-w\fR -options\&. The -\fB\-W\fR -option makes -\fBhost\fR -wait for -\fIwait\fR -seconds\&. 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\&. -.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 +\-m \fIflag\fR +.RS 4 +Memory usage debugging: the flag can be \fIrecord\fR, -\fIusage\fR -and -\fItrace\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\-V\fR -option causes +\-v +.RS 4 +Verbose output\&. Equivalent to the +\fB\-d\fR +debug option\&. +.RE +.PP +\-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 +option\&. +.RE +.PP +\-W \fIwait\fR +.RS 4 +Timeout: wait for up to +\fIwait\fR +seconds for a reply\&. If +\fIwait\fR +is less than one, the wait interval is set to one second\&. +.sp +By default, \fBhost\fR -to print the version number and exit\&. +will wait for 5 seconds for UDP responses and 10 seconds for TCP connections\&. +.sp +See also the +\fB\-w\fR +option\&. +.RE .SH "IDN SUPPORT" .PP If @@ -237,7 +266,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 fb8c08f67e..73c32428e0 100644 --- a/bin/dig/host.html +++ b/bin/dig/host.html @@ -1,5 +1,5 @@