From f7b41fd9291b8f4dba27e2b57e1d93f0913a4f1d Mon Sep 17 00:00:00 2001
From: Mark Andrews
Date: Mon, 21 May 2007 04:09:03 +0000
Subject: [PATCH] regen
---
bin/check/named-checkconf.8 | 9 +-
bin/check/named-checkconf.html | 18 +--
bin/check/named-checkzone.8 | 15 ++-
bin/check/named-checkzone.html | 20 ++--
doc/arm/Bv9ARM.ch06.html | 121 ++++++++++++--------
doc/arm/Bv9ARM.ch07.html | 14 +--
doc/arm/Bv9ARM.ch08.html | 18 +--
doc/arm/Bv9ARM.ch09.html | 182 +++++++++++++++----------------
doc/arm/Bv9ARM.html | 50 ++++-----
doc/arm/man.dig.html | 20 ++--
doc/arm/man.dnssec-keygen.html | 14 +--
doc/arm/man.dnssec-signzone.html | 12 +-
doc/arm/man.host.html | 10 +-
doc/arm/man.named-checkconf.html | 18 +--
doc/arm/man.named-checkzone.html | 20 ++--
doc/arm/man.named.html | 16 +--
doc/arm/man.rndc-confgen.html | 12 +-
doc/arm/man.rndc.conf.html | 12 +-
doc/arm/man.rndc.html | 12 +-
19 files changed, 330 insertions(+), 263 deletions(-)
diff --git a/bin/check/named-checkconf.8 b/bin/check/named-checkconf.8
index e1ddf63938..f579750bb1 100644
--- a/bin/check/named-checkconf.8
+++ b/bin/check/named-checkconf.8
@@ -13,7 +13,7 @@
.\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\" PERFORMANCE OF THIS SOFTWARE.
.\"
-.\" $Id: named-checkconf.8,v 1.28 2007/05/09 03:33:50 marka Exp $
+.\" $Id: named-checkconf.8,v 1.29 2007/05/21 04:09:03 marka Exp $
.\"
.hy 0
.ad l
@@ -33,13 +33,18 @@
named\-checkconf \- named configuration file syntax checking tool
.SH "SYNOPSIS"
.HP 16
-\fBnamed\-checkconf\fR [\fB\-v\fR] [\fB\-j\fR] [\fB\-t\ \fR\fB\fIdirectory\fR\fR] {filename} [\fB\-z\fR]
+\fBnamed\-checkconf\fR [\fB\-h\fR] [\fB\-v\fR] [\fB\-j\fR] [\fB\-t\ \fR\fB\fIdirectory\fR\fR] {filename} [\fB\-z\fR]
.SH "DESCRIPTION"
.PP
\fBnamed\-checkconf\fR
checks the syntax, but not the semantics, of a named configuration file.
.SH "OPTIONS"
.PP
+\-h
+.RS 4
+Print the usage summary and exit.
+.RE
+.PP
\-t \fIdirectory\fR
.RS 4
Chroot to
diff --git a/bin/check/named-checkconf.html b/bin/check/named-checkconf.html
index 88de098019..2b1cc349c1 100644
--- a/bin/check/named-checkconf.html
+++ b/bin/check/named-checkconf.html
@@ -14,7 +14,7 @@
- OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
- PERFORMANCE OF THIS SOFTWARE.
-->
-
+
@@ -29,18 +29,22 @@
Synopsis
-
named-checkconf
[-v
] [-j
] [-t directory
] {filename} [-z
]
+
named-checkconf
[-h
] [-v
] [-j
] [-t directory
] {filename} [-z
]
-
DESCRIPTION
+
DESCRIPTION
named-checkconf
checks the syntax, but not the semantics, of a named
configuration file.
-
OPTIONS
+
OPTIONS
+- -h
+
+ Print the usage summary and exit.
+
- -t
directory
Chroot to directory
so that
@@ -70,20 +74,20 @@
-
RETURN VALUES
+
RETURN VALUES
named-checkconf
returns an exit status of 1 if
errors were detected and 0 otherwise.
-
SEE ALSO
+
SEE ALSO
named(8),
BIND 9 Administrator Reference Manual.
-
AUTHOR
+
AUTHOR
Internet Systems Consortium
diff --git a/bin/check/named-checkzone.8 b/bin/check/named-checkzone.8
index a92c3cd0f2..02b952a99d 100644
--- a/bin/check/named-checkzone.8
+++ b/bin/check/named-checkzone.8
@@ -13,7 +13,7 @@
.\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\" PERFORMANCE OF THIS SOFTWARE.
.\"
-.\" $Id: named-checkzone.8,v 1.40 2007/05/09 13:35:57 marka Exp $
+.\" $Id: named-checkzone.8,v 1.41 2007/05/21 04:09:03 marka Exp $
.\"
.hy 0
.ad l
@@ -33,7 +33,7 @@
named\-checkzone, named\-compilezone \- zone file validity checking or converting tool
.SH "SYNOPSIS"
.HP 16
-\fBnamed\-checkzone\fR [\fB\-d\fR] [\fB\-j\fR] [\fB\-q\fR] [\fB\-v\fR] [\fB\-c\ \fR\fB\fIclass\fR\fR] [\fB\-f\ \fR\fB\fIformat\fR\fR] [\fB\-F\ \fR\fB\fIformat\fR\fR] [\fB\-i\ \fR\fB\fImode\fR\fR] [\fB\-k\ \fR\fB\fImode\fR\fR] [\fB\-m\ \fR\fB\fImode\fR\fR] [\fB\-M\ \fR\fB\fImode\fR\fR] [\fB\-n\ \fR\fB\fImode\fR\fR] [\fB\-o\ \fR\fB\fIfilename\fR\fR] [\fB\-s\ \fR\fB\fIstyle\fR\fR] [\fB\-S\ \fR\fB\fImode\fR\fR] [\fB\-t\ \fR\fB\fIdirectory\fR\fR] [\fB\-w\ \fR\fB\fIdirectory\fR\fR] [\fB\-D\fR] [\fB\-W\ \fR\fB\fImode\fR\fR] {zonename} {filename}
+\fBnamed\-checkzone\fR [\fB\-d\fR] [\fB\-h\fR] [\fB\-j\fR] [\fB\-q\fR] [\fB\-v\fR] [\fB\-c\ \fR\fB\fIclass\fR\fR] [\fB\-f\ \fR\fB\fIformat\fR\fR] [\fB\-F\ \fR\fB\fIformat\fR\fR] [\fB\-i\ \fR\fB\fImode\fR\fR] [\fB\-k\ \fR\fB\fImode\fR\fR] [\fB\-m\ \fR\fB\fImode\fR\fR] [\fB\-M\ \fR\fB\fImode\fR\fR] [\fB\-n\ \fR\fB\fImode\fR\fR] [\fB\-o\ \fR\fB\fIfilename\fR\fR] [\fB\-s\ \fR\fB\fIstyle\fR\fR] [\fB\-S\ \fR\fB\fImode\fR\fR] [\fB\-t\ \fR\fB\fIdirectory\fR\fR] [\fB\-w\ \fR\fB\fIdirectory\fR\fR] [\fB\-D\fR] [\fB\-W\ \fR\fB\fImode\fR\fR] {zonename} {filename}
.HP 18
\fBnamed\-compilezone\fR [\fB\-d\fR] [\fB\-j\fR] [\fB\-q\fR] [\fB\-v\fR] [\fB\-c\ \fR\fB\fIclass\fR\fR] [\fB\-C\ \fR\fB\fImode\fR\fR] [\fB\-f\ \fR\fB\fIformat\fR\fR] [\fB\-F\ \fR\fB\fIformat\fR\fR] [\fB\-i\ \fR\fB\fImode\fR\fR] [\fB\-k\ \fR\fB\fImode\fR\fR] [\fB\-m\ \fR\fB\fImode\fR\fR] [\fB\-n\ \fR\fB\fImode\fR\fR] [\fB\-o\ \fR\fB\fIfilename\fR\fR] [\fB\-s\ \fR\fB\fIstyle\fR\fR] [\fB\-t\ \fR\fB\fIdirectory\fR\fR] [\fB\-w\ \fR\fB\fIdirectory\fR\fR] [\fB\-D\fR] [\fB\-W\ \fR\fB\fImode\fR\fR] {zonename} {filename}
.SH "DESCRIPTION"
@@ -58,6 +58,11 @@ configuration file.
Enable debugging.
.RE
.PP
+\-h
+.RS 4
+Print the usage summary and exit.
+.RE
+.PP
\-q
.RS 4
Quiet mode \- exit code only.
@@ -188,7 +193,11 @@ Specify whether NS records should be checked to see if they are addresses. Possi
\-o \fIfilename\fR
.RS 4
Write zone output to
-\fIfilename\fR. This is mandatory for
+\fIfilename\fR. If
+\fIfilename\fR
+is
+\fI\-\fR
+then write to standard out. This is mandatory for
\fBnamed\-compilezone\fR.
.RE
.PP
diff --git a/bin/check/named-checkzone.html b/bin/check/named-checkzone.html
index 8b88ffe716..33e9d00e7f 100644
--- a/bin/check/named-checkzone.html
+++ b/bin/check/named-checkzone.html
@@ -14,7 +14,7 @@
- OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
- PERFORMANCE OF THIS SOFTWARE.
-->
-
+
@@ -29,11 +29,11 @@
Synopsis
-
named-checkzone
[-d
] [-j
] [-q
] [-v
] [-c class
] [-f format
] [-F format
] [-i mode
] [-k mode
] [-m mode
] [-M mode
] [-n mode
] [-o filename
] [-s style
] [-S mode
] [-t directory
] [-w directory
] [-D
] [-W mode
] {zonename} {filename}
+
named-checkzone
[-d
] [-h
] [-j
] [-q
] [-v
] [-c class
] [-f format
] [-F format
] [-i mode
] [-k mode
] [-m mode
] [-M mode
] [-n mode
] [-o filename
] [-s style
] [-S mode
] [-t directory
] [-w directory
] [-D
] [-W mode
] {zonename} {filename}
named-compilezone
[-d
] [-j
] [-q
] [-v
] [-c class
] [-C mode
] [-f format
] [-F format
] [-i mode
] [-k mode
] [-m mode
] [-n mode
] [-o filename
] [-s style
] [-t directory
] [-w directory
] [-D
] [-W mode
] {zonename} {filename}
-
DESCRIPTION
+
DESCRIPTION
named-checkzone
checks the syntax and integrity of a zone file. It performs the
same checks as named does when loading a
@@ -53,12 +53,16 @@
-
OPTIONS
+
OPTIONS
- -d
Enable debugging.
+- -h
+
+ Print the usage summary and exit.
+
- -q
Quiet mode - exit code only.
@@ -169,6 +173,8 @@
- -o
filename
Write zone output to filename
.
+ If filename
is -
then
+ write to standard out.
This is mandatory for named-compilezone.
- -s
style
@@ -233,21 +239,21 @@
-
RETURN VALUES
+
RETURN VALUES
named-checkzone
returns an exit status of 1 if
errors were detected and 0 otherwise.
-
SEE ALSO
+
SEE ALSO
named(8),
RFC 1035,
BIND 9 Administrator Reference Manual.
-
AUTHOR
+
AUTHOR
Internet Systems Consortium
diff --git a/doc/arm/Bv9ARM.ch06.html b/doc/arm/Bv9ARM.ch06.html
index 4c2b146419..4263614d4f 100644
--- a/doc/arm/Bv9ARM.ch06.html
+++ b/doc/arm/Bv9ARM.ch06.html
@@ -14,7 +14,7 @@
- OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
- PERFORMANCE OF THIS SOFTWARE.
-->
-
+
@@ -66,34 +66,34 @@
logging Statement Grammar
logging Statement Definition and
Usage
-lwres Statement Grammar
-lwres Statement Definition and Usage
-masters Statement Grammar
-masters Statement Definition and
+lwres Statement Grammar
+lwres Statement Definition and Usage
+masters Statement Grammar
+masters Statement Definition and
Usage
-options Statement Grammar
+options Statement Grammar
options Statement Definition and
Usage
server Statement Grammar
server Statement Definition and
Usage
-trusted-keys Statement Grammar
-trusted-keys Statement Definition
+trusted-keys Statement Grammar
+trusted-keys Statement Definition
and Usage
view Statement Grammar
-view Statement Definition and Usage
+view Statement Definition and Usage
zone
Statement Grammar
-zone Statement Definition and Usage
+zone Statement Definition and Usage
-Zone File
+Zone File
- Types of Resource Records and When to Use Them
-- Discussion of MX Records
+- Discussion of MX Records
- Setting TTLs
-- Inverse Mapping in IPv4
-- Other Zone File Directives
-- BIND Master File Extension: the $GENERATE Directive
+- Inverse Mapping in IPv4
+- Other Zone File Directives
+- BIND Master File Extension: the $GENERATE Directive
- Additional File Formats
@@ -1634,13 +1634,46 @@ category notify { null; };
+
+
+ edns-disabled
+ |
+
+
+ Log queries that have been forced to use plain
+ DNS due to timeouts. This is often due to
+ the remote servers not being RFC 1034 compliant
+ (not always returning FORMERR or similar to
+ EDNS queries and other extension to the DNS
+ when they are not understood). i.e. this is
+ targeted at servers that fail to respond to
+ DNS queries that they don't understand.
+
+
+ Note: the log message can be also due to
+ packet loss. Before reporting servers for
+ non RFC 1034 compliance they should be re-tested
+ to determine the nature of of the non-compliance.
+ This testing should prevent / reduce the
+ number of false positive reports.
+
+
+ Note: eventually named will have to stop
+ treating such timeouts as due to RFC 1034 non
+ compliance and start treating it as plain
+ packet loss as falsely classifying packet
+ loss as due to RFC 1034 non compliance impacts
+ on DNSSEC validation.
+
+ |
+
This is the grammar of the lwres
statement in the named.conf
file:
@@ -1655,7 +1688,7 @@ category notify { null; };
-lwres Statement Definition and Usage
+
lwres Statement Definition and Usage
The lwres statement configures the
name
@@ -1706,14 +1739,14 @@ category notify { null; };
-masters Statement Grammar
+
masters Statement Grammar
masters name
[port ip_port
] { ( masters_list
| ip_addr
[port ip_port
] [key key
] ) ; [...] };
-masters Statement Definition and
+masters Statement Definition and
Usage
masters
lists allow for a common set of masters to be easily used by
@@ -1722,7 +1755,7 @@ category notify { null; };
-options Statement Grammar
+
options Statement Grammar
This is the grammar of the options
statement in the named.conf
file:
@@ -2809,7 +2842,7 @@ options {
The forwarding facility can be used to create a large site-wide
cache on a few servers, reducing traffic over links to external
@@ -2853,7 +2886,7 @@ options {
Dual-stack servers are used as servers of last resort to work
around
@@ -3056,7 +3089,7 @@ options {
The interfaces and ports that the server will answer queries
from may be specified using the listen-on option. listen-on takes
@@ -3440,7 +3473,7 @@ query-source-v6 address * port *;
avoid-v4-udp-ports
and avoid-v6-udp-ports specify a list
of IPv4 and IPv6 UDP ports that will not be used as system
@@ -3454,7 +3487,7 @@ query-source-v6 address * port *;
-Operating System Resource Limits
+
Operating System Resource Limits
The server's usage of many system resources can be limited.
Scaled values are allowed when specifying resource limits. For
@@ -3513,7 +3546,7 @@ query-source-v6 address * port *;
The following options set limits on the server's
resource consumption that are enforced internally by the
@@ -3591,7 +3624,7 @@ query-source-v6 address * port *;
- cleaning-interval
@@ -4648,7 +4681,7 @@ query-source-v6 address * port *;
-trusted-keys Statement Grammar
+
trusted-keys Statement Grammar
trusted-keys {
string
number
number
number
string
;
[ string
number
number
number
string
; [...]]
@@ -4657,7 +4690,7 @@ query-source-v6 address * port *;
-trusted-keys Statement Definition
+trusted-keys Statement Definition
and Usage
The trusted-keys statement defines
@@ -4700,7 +4733,7 @@ query-source-v6 address * port *;
-view Statement Definition and Usage
+
view Statement Definition and Usage
The view statement is a powerful
feature
@@ -4956,10 +4989,10 @@ zone zone_name
[
-zone Statement Definition and Usage
+
zone Statement Definition and Usage