Browse Source

[master] commit regenerated manuals

This documentation was updated previously in Docook XML format,
now commit the regenerated nroff versions.
Jeremy C. Reed 13 years ago
parent
commit
56f15f53c1
2 changed files with 17 additions and 12 deletions
  1. 13 8
      src/bin/xfrout/b10-xfrout.8
  2. 4 4
      src/bin/zonemgr/b10-zonemgr.8

+ 13 - 8
src/bin/xfrout/b10-xfrout.8

@@ -2,12 +2,12 @@
 .\"     Title: b10-xfrout
 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
-.\"      Date: December 1, 2010
+.\"      Date: December 15, 2011
 .\"    Manual: BIND10
 .\"    Source: BIND10
 .\"  Language: English
 .\"
-.TH "B10\-XFROUT" "8" "December 1, 2010" "BIND10" "BIND10"
+.TH "B10\-XFROUT" "8" "December 15, 2011" "BIND10" "BIND10"
 .\" -----------------------------------------------------------------
 .\" * set default formatting
 .\" -----------------------------------------------------------------
@@ -27,7 +27,7 @@ b10-xfrout \- Outbound DNS zone transfer service
 .PP
 The
 \fBb10\-xfrout\fR
-daemon provides the BIND 10 outgoing DNS zone transfer service\&. It is also used to send outgoing NOTIFY messages\&. Normally it is started by the
+daemon provides the BIND 10 outgoing DNS zone transfer service using AXFR or IXFR\&. It is also used to send outgoing NOTIFY messages\&. Normally it is started by the
 \fBbind10\fR(8)
 boss process\&. When the
 \fBb10\-auth\fR
@@ -47,11 +47,10 @@ sends the zone as found in the BIND 10 zone data store\&.
 .ps -1
 .br
 .sp
-This development prototype release only supports AXFR\&. IXFR is not implemented\&.
+Currently IXFR only works if it gets the zone via \fBb10\-xfrin\fR and only on TCP\&.
 .sp .5v
 .RE
 .PP
-
 This daemon communicates with BIND 10 over a
 \fBb10-msgq\fR(8)
 C\-Channel connection\&. If this connection is not established,
@@ -72,16 +71,22 @@ defines the maximum number of outgoing zone transfers that can run concurrently\
 .PP
 
 \fItsig_key_ring\fR
-A list of TSIG keys (each of which is in the form of name:base64\-key[:algorithm]) used for access control on transfer requests\&. The default is an empty list\&.
+A list of TSIG keys (each of which is in the form of
+\fIname:base64\-key[:algorithm]\fR) used for access control on transfer requests\&. The default is an empty list\&.
 .PP
 
 \fItransfer_acl\fR
-A list of ACL elements that apply to all transfer requests by default (unless overridden in zone_config)\&. See the BIND 10 guide for configuration examples\&. The default is an element that allows any transfer requests\&.
+A list of ACL elements that apply to all transfer requests by default (unless overridden in
+\fIzone_config\fR)\&. See the
+BIND 10 Guide
+for configuration examples\&. The default is an element that allows any transfer requests\&.
 .PP
 
 \fIzone_config\fR
 A list of JSON objects (i\&.e\&. maps) that define per zone configuration concerning
-\fBb10\-xfrout\fR\&. The supported names of each object are "origin" (the origin name of the zone), "class" (the RR class of the zone, optional, default to "IN"), and "acl_element" (ACL only applicable to transfer requests for that zone)\&. See the BIND 10 guide for configuration examples\&. The default is an empty list, that is, no zone specific configuration\&.
+\fBb10\-xfrout\fR\&. The supported names of each object are "origin" (the origin name of the zone), "class" (the RR class of the zone, optional, default to "IN"), and "transfer_acl" (ACL only applicable to transfer requests for that zone)\&. See the
+BIND 10 Guide
+for configuration examples\&. The default is an empty list, that is, no zone specific configuration\&.
 .PP
 
 \fIlog_name\fR

+ 4 - 4
src/bin/zonemgr/b10-zonemgr.8

@@ -2,12 +2,12 @@
 .\"     Title: b10-zonemgr
 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
-.\"      Date: May 19, 2011
+.\"      Date: December 8, 2011
 .\"    Manual: BIND10
 .\"    Source: BIND10
 .\"  Language: English
 .\"
-.TH "B10\-ZONEMGR" "8" "May 19, 2011" "BIND10" "BIND10"
+.TH "B10\-ZONEMGR" "8" "December 8, 2011" "BIND10" "BIND10"
 .\" -----------------------------------------------------------------
 .\" * set default formatting
 .\" -----------------------------------------------------------------
@@ -55,10 +55,11 @@ defines the minimum SOA RETRY time in seconds\&. The default is 5\&.
 .PP
 
 \fIrefresh_jitter\fR
-This value is a real number\&. The maximum amount is 0\&.5\&. The default is 0\&.25\&.
+is used to provide a time range for randomizing the refresh and retry timers to help avoid many zones needing to do a refresh or retry at the same time\&. This value is a real number\&. The maximum amount is 0\&.5 (the new timer will be within half the original time)\&. The default is 0\&.25 (up to a quarter sooner)\&. Set to 0 to disable this jitter\&.
 .PP
 
 \fIreload_jitter\fR
+
 This value is a real number\&. The default is 0\&.75\&.
 .PP
 
@@ -118,7 +119,6 @@ This is an internal command and not exposed to the administrator\&.
 \fBb10-cfgmgr\fR(8),
 \fBb10-msgq\fR(8),
 \fBb10-xfrin\fR(8),
-\fBb10-xfrout\fR(8),
 \fBbind10\fR(8),
 BIND 10 Guide\&.
 .SH "HISTORY"