|
|
@@ -0,0 +1,203 @@
|
|
|
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
|
|
|
+ "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
|
|
|
+ [<!ENTITY mdash "—">]>
|
|
|
+<!--
|
|
|
+ - Copyright (C) 2010 Internet Systems Consortium, Inc. ("ISC")
|
|
|
+ -
|
|
|
+ - Permission to use, copy, modify, and/or distribute this software for any
|
|
|
+ - purpose with or without fee is hereby granted, provided that the above
|
|
|
+ - copyright notice and this permission notice appear in all copies.
|
|
|
+ -
|
|
|
+ - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
|
|
|
+ - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
|
|
|
+ - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
|
|
|
+ - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
|
|
|
+ - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
|
|
|
+ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
|
+ - PERFORMANCE OF THIS SOFTWARE.
|
|
|
+-->
|
|
|
+
|
|
|
+<!-- $Id$ -->
|
|
|
+<refentry>
|
|
|
+
|
|
|
+ <refentryinfo>
|
|
|
+ <date>September 8, 2010</date>
|
|
|
+ </refentryinfo>
|
|
|
+
|
|
|
+ <refmeta>
|
|
|
+ <refentrytitle>b10-zonemgr</refentrytitle>
|
|
|
+ <manvolnum>8</manvolnum>
|
|
|
+ <refmiscinfo>BIND10</refmiscinfo>
|
|
|
+ </refmeta>
|
|
|
+
|
|
|
+ <refnamediv>
|
|
|
+ <refname>b10-zonemgr</refname>
|
|
|
+ <refpurpose>BIND 10 Secondary zone manager</refpurpose>
|
|
|
+ </refnamediv>
|
|
|
+
|
|
|
+ <docinfo>
|
|
|
+ <copyright>
|
|
|
+ <year>2010</year>
|
|
|
+ <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
|
|
|
+ </copyright>
|
|
|
+ </docinfo>
|
|
|
+
|
|
|
+ <refsynopsisdiv>
|
|
|
+ <cmdsynopsis>
|
|
|
+ <command>b10-zonemgr</command>
|
|
|
+ <arg><option>-v</option></arg>
|
|
|
+ <arg><option>--verbose</option></arg>
|
|
|
+ </cmdsynopsis>
|
|
|
+ </refsynopsisdiv>
|
|
|
+
|
|
|
+ <refsect1>
|
|
|
+ <title>DESCRIPTION</title>
|
|
|
+ <para>The <command>b10-zonemgr</command> daemon, also known
|
|
|
+ as the BIND 10 secondary manager, keeps track of timers
|
|
|
+ and other information necessary for BIND 10 to act as a DNS slave.
|
|
|
+ Normally it is started by the
|
|
|
+ <citerefentry><refentrytitle>bind10</refentrytitle><manvolnum>8</manvolnum></citerefentry>
|
|
|
+ boss process.
|
|
|
+ </para>
|
|
|
+
|
|
|
+ <para>
|
|
|
+ This daemon communicates with BIND 10 over a
|
|
|
+ <citerefentry><refentrytitle>b10-msgq</refentrytitle><manvolnum>8</manvolnum></citerefentry>
|
|
|
+ C-Channel connection. If this connection is not established,
|
|
|
+ <command>b10-zonemgr</command> will exit.
|
|
|
+<!-- TODO what if connection closes later, will b10-zonemgr exit? -->
|
|
|
+ </para>
|
|
|
+
|
|
|
+ <para>
|
|
|
+ <command>b10-zonemgr</command> receives its configurations from
|
|
|
+<citerefentry><refentrytitle>b10-cfgmgr</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
|
|
|
+ </para>
|
|
|
+
|
|
|
+<!--
|
|
|
+
|
|
|
+ self._send_command(XFRIN_MODULE_NAME, ZONE_NOTIFY_COMMAND, param)
|
|
|
+ self._clear_zone_notifier_master(zone_name_class)
|
|
|
+ # Send refresh command to xfrin module
|
|
|
+ else:
|
|
|
+ param = {"zone_name" : zone_name_class[0],
|
|
|
+ "zone_class" : zone_name_class[1]
|
|
|
+ }
|
|
|
+ self._send_command(XFRIN_MODULE_NAME, ZONE_REFRESH_COMMAND, param)
|
|
|
+
|
|
|
+-->
|
|
|
+
|
|
|
+ </refsect1>
|
|
|
+
|
|
|
+ <refsect1>
|
|
|
+ <title>CONFIGURATION AND COMMANDS</title>
|
|
|
+ <para>
|
|
|
+ The configurable settings are:
|
|
|
+ </para>
|
|
|
+<!--
|
|
|
+ <para>
|
|
|
+ <varname>transfers-out</varname>
|
|
|
+ defines the maximum number of outgoing zone transfers
|
|
|
+ that can run concurrently. The default is 10.
|
|
|
+ </para>
|
|
|
+-->
|
|
|
+
|
|
|
+<!-- TODO: formating -->
|
|
|
+ <para>
|
|
|
+ The configuration commands are:
|
|
|
+ </para>
|
|
|
+ <para>
|
|
|
+ <command>notify</command> (sent by
|
|
|
+ <command>b10-auth</command>) tells <command>b10-zonemgr</command>
|
|
|
+ the zone name and class, and the IP address for the master
|
|
|
+ (source of the NOTIFY message).
|
|
|
+ This will set the zone's refresh time to now.
|
|
|
+<!-- TODO reword this -->
|
|
|
+ </para>
|
|
|
+
|
|
|
+ <para>
|
|
|
+ <command>shutdown</command> exits <command>b10-zonemgr</command>.
|
|
|
+ (Note that the BIND 10 boss process will restart this service.)
|
|
|
+ </para>
|
|
|
+
|
|
|
+ <para>
|
|
|
+ <command>zone_new_data_ready</command> is sent from
|
|
|
+ <command>b10-xfrin</command> to indicate that the zone transferred
|
|
|
+ in successfully.
|
|
|
+ </para>
|
|
|
+
|
|
|
+ <para>
|
|
|
+ <command>zone_xfrin_failed</command> is sent from
|
|
|
+ <command>b10-xfrin</command> to indicate a failure
|
|
|
+ (such as transfer-in was incomplete).
|
|
|
+ The refresh timer for the zone is reset.
|
|
|
+<!--
|
|
|
+ """Set zone next refresh time after zone refresh fail.
|
|
|
+ now + retry*3/4 <= next_refresh_time <= now + retry
|
|
|
+-->
|
|
|
+ </para>
|
|
|
+
|
|
|
+ </refsect1>
|
|
|
+
|
|
|
+<!--
|
|
|
+ <refsect1>
|
|
|
+ <title>OPTIONS</title>
|
|
|
+
|
|
|
+ <para>The arguments are as follows:</para>
|
|
|
+
|
|
|
+ <variablelist>
|
|
|
+ <varlistentry>
|
|
|
+ <term><option></option></term>
|
|
|
+ <listitem><para>
|
|
|
+ </para></listitem>
|
|
|
+ </varlistentry>
|
|
|
+
|
|
|
+ </variablelist>
|
|
|
+
|
|
|
+ </refsect1>
|
|
|
+-->
|
|
|
+<!--
|
|
|
+ <refsect1>
|
|
|
+ <title>FILES</title>
|
|
|
+ <para>
|
|
|
+ <filename>/tmp/auth_xfrout_conn</filename>
|
|
|
+ </para>
|
|
|
+ </refsect1>
|
|
|
+-->
|
|
|
+
|
|
|
+ <refsect1>
|
|
|
+ <title>SEE ALSO</title>
|
|
|
+ <para>
|
|
|
+ <citerefentry>
|
|
|
+ <refentrytitle>b10-auth</refentrytitle><manvolnum>8</manvolnum>
|
|
|
+ </citerefentry>,
|
|
|
+ <citerefentry>
|
|
|
+ <refentrytitle>b10-cfgmgr</refentrytitle><manvolnum>8</manvolnum>
|
|
|
+ </citerefentry>,
|
|
|
+ <citerefentry>
|
|
|
+ <refentrytitle>b10-msgq</refentrytitle><manvolnum>8</manvolnum>
|
|
|
+ </citerefentry>,
|
|
|
+ <citerefentry>
|
|
|
+ <refentrytitle>b10-xfrin</refentrytitle><manvolnum>8</manvolnum>
|
|
|
+ </citerefentry>,
|
|
|
+ <citerefentry>
|
|
|
+ <refentrytitle>b10-xfrout</refentrytitle><manvolnum>8</manvolnum>
|
|
|
+ </citerefentry>,
|
|
|
+ <citerefentry>
|
|
|
+ <refentrytitle>bind10</refentrytitle><manvolnum>8</manvolnum>
|
|
|
+ </citerefentry>,
|
|
|
+ <citetitle>BIND 10 Guide</citetitle>.
|
|
|
+ </para>
|
|
|
+ </refsect1>
|
|
|
+
|
|
|
+ <refsect1>
|
|
|
+ <title>HISTORY</title>
|
|
|
+ <para>
|
|
|
+ The <command>b10-zonemgr</command> daemon was designed in July 2010
|
|
|
+ by CNNIC for the ISC BIND 10 project.
|
|
|
+ </para>
|
|
|
+ </refsect1>
|
|
|
+</refentry><!--
|
|
|
+ - Local variables:
|
|
|
+ - mode: sgml
|
|
|
+ - End:
|
|
|
+-->
|
Jeremy C. Reed