2
0
mirror of https://gitlab.isc.org/isc-projects/kea synced 2025-08-31 05:55:28 +00:00

[master] document Xfrout notify command.

And remove the now renamed/removed internal only zone_new_data_ready
command.

Regenerate nroff file too (which includes

No new changelog entry. This goes with changelog entry 402.

Somewhat discussed on jabber. Didn't get consensus on one sentence,
but that can always be clarified later.
This commit is contained in:
Jeremy C. Reed
2012-03-22 07:50:50 -05:00
parent 154021bfa4
commit 2482bf2363
2 changed files with 27 additions and 41 deletions

View File

@@ -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: February 28. 2012
.\" Date: March 16. 2012
.\" Manual: BIND10
.\" Source: BIND10
.\" Language: English
.\"
.TH "B10\-XFROUT" "8" "February 28\&. 2012" "BIND10" "BIND10"
.TH "B10\-XFROUT" "8" "March 16\&. 2012" "BIND10" "BIND10"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@@ -82,26 +82,6 @@ A list of JSON objects (i\&.e\&. maps) that define per zone configuration concer
\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
.PP
\fIlog_file\fR
The location of the log file if using a file channel\&. If undefined, then the file channel is closed\&. The default is
/usr/local/var/bind10\-devel/log/Xfrout\&.log\&.
.PP
\fIlog_severity\fR
The default is "debug"\&.
.PP
\fIlog_versions\fR
The default is 5\&.
.PP
\fIlog_max_bytes\fR
The default is 1048576\&.
.if n \{\
.sp
.\}
@@ -122,19 +102,24 @@ This prototype version uses SQLite3 as its data source backend\&. Future version
The configuration commands are:
.PP
\fBnotify\fR
triggers
\fBb10\-xfrout\fR
to send NOTIFY message(s)\&. It has the following arguments:
\fIzone_name\fR
to define the zone to send notifies for and the optional
\fIzone_class\fR
to define the class (defaults to
\(lqIN\(rq)\&.
\fBb10-xfrin\fR(8)
sends this command when a zone transferred in successfully\&.
.PP
\fBshutdown\fR
stops all outbound zone transfers and exits
\fBb10\-xfrout\fR\&. This has an optional
\fIpid\fR
argument to select the process ID to stop\&. (Note that the BIND 10 boss process may restart this service if configured\&.)
.PP
\fBzone_new_data_ready\fR
is sent from
\fBb10-xfrin\fR(8)
to indicate that the zone transferred in successfully\&. This triggers
\fBb10\-xfrout\fR
to send NOTIFY message(s)\&. This is an internal command and not exposed to the administrator\&.
.SH "SEE ALSO"
.PP

View File

@@ -20,7 +20,7 @@
<refentry>
<refentryinfo>
<date>February 28. 2012</date>
<date>March 16. 2012</date>
</refentryinfo>
<refmeta>
@@ -131,6 +131,17 @@
The configuration commands are:
</para>
<para>
<command>notify</command> triggers <command>b10-xfrout</command>
to send NOTIFY message(s).
It has the following arguments: <varname>zone_name</varname>
to define the zone to send notifies for and the optional
<varname>zone_class</varname> to define the class (defaults to
<quote>IN</quote>).
<citerefentry><refentrytitle>b10-xfrin</refentrytitle><manvolnum>8</manvolnum></citerefentry>
sends this command when a zone transferred in successfully.
</para>
<para>
<command>shutdown</command> stops all outbound zone transfers
and exits <command>b10-xfrout</command>.
@@ -140,16 +151,6 @@
if configured.)
</para>
<para>
<command>zone_new_data_ready</command> is sent from
<citerefentry><refentrytitle>b10-xfrin</refentrytitle><manvolnum>8</manvolnum></citerefentry>
to indicate that the zone transferred in successfully.
This triggers <command>b10-xfrout</command> to send NOTIFY
message(s).
This is an internal command and not exposed to the administrator.
<!-- not defined in spec -->
</para>
</refsect1>
<!--