2
0
mirror of https://gitlab.isc.org/isc-projects/bind9 synced 2025-08-29 13:38:26 +00:00

updated notify-source documentation to reflect simplified default

processing; other editing affecting mainly the various *-source options
This commit is contained in:
Andreas Gustafsson 2000-11-28 19:16:23 +00:00
parent 7f317e65c2
commit f6ec00228a

View File

@ -2,7 +2,7 @@
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.0//EN" <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.0//EN"
"http://www.oasis-open.org/docbook/xml/4.0/docbookx.dtd"> "http://www.oasis-open.org/docbook/xml/4.0/docbookx.dtd">
<!-- File: $Id: Bv9ARM-book.xml,v 1.52 2000/11/28 18:55:56 gson Exp $ --> <!-- File: $Id: Bv9ARM-book.xml,v 1.53 2000/11/28 19:16:23 gson Exp $ -->
<book> <book>
@ -2477,10 +2477,10 @@ lookups performed on behalf of clients by a caching name server.</para></entry>
<optional> transfers-in <replaceable>number</replaceable>; </optional> <optional> transfers-in <replaceable>number</replaceable>; </optional>
<optional> transfers-out <replaceable>number</replaceable>; </optional> <optional> transfers-out <replaceable>number</replaceable>; </optional>
<optional> transfers-per-ns <replaceable>number</replaceable>; </optional> <optional> transfers-per-ns <replaceable>number</replaceable>; </optional>
<optional> transfer-source <replaceable>ip4_addr</replaceable> <optional>port <replaceable>ip_port</replaceable></optional> ; </optional> <optional> transfer-source (<replaceable>ip4_addr</replaceable> | <constant>*</constant>) <optional>port <replaceable>ip_port</replaceable></optional> ; </optional>
<optional> transfer-source-v6 <replaceable>ip6_addr</replaceable> <optional>port <replaceable>ip_port</replaceable></optional> ; </optional> <optional> transfer-source-v6 (<replaceable>ip6_addr</replaceable> | <constant>*</constant>) <optional>port <replaceable>ip_port</replaceable></optional> ; </optional>
<optional> notify-source <replaceable>ip4_addr</replaceable> <optional>port <replaceable>ip_port</replaceable></optional> ; </optional> <optional> notify-source (<replaceable>ip4_addr</replaceable> | <constant>*</constant>) <optional>port <replaceable>ip_port</replaceable></optional> ; </optional>
<optional> notify-source-v6 <replaceable>ip6_addr</replaceable> <optional>port <replaceable>ip_port</replaceable></optional> ; </optional> <optional> notify-source-v6 (<replaceable>ip6_addr</replaceable> | <constant>*</constant>) <optional>port <replaceable>ip_port</replaceable></optional> ; </optional>
<optional> also-notify { <replaceable>ip_addr</replaceable> <optional>port <replaceable>ip_port</replaceable></optional> ; <optional> <replaceable>ip_addr</replaceable> <optional>port <replaceable>ip_port</replaceable></optional> ; ... </optional> }; </optional> <optional> also-notify { <replaceable>ip_addr</replaceable> <optional>port <replaceable>ip_port</replaceable></optional> ; <optional> <replaceable>ip_addr</replaceable> <optional>port <replaceable>ip_port</replaceable></optional> ; ... </optional> }; </optional>
<optional> max-ixfr-log-size <replaceable>number</replaceable>; </optional> <optional> max-ixfr-log-size <replaceable>number</replaceable>; </optional>
<optional> coresize <replaceable>size_spec</replaceable> ; </optional> <optional> coresize <replaceable>size_spec</replaceable> ; </optional>
@ -3111,15 +3111,16 @@ of the <command>server</command> statement.</para></entry>
<entry colname = "2"><para><command>transfer-source</command> determines <entry colname = "2"><para><command>transfer-source</command> determines
which local address will be bound to IPv4 TCP connections used to which local address will be bound to IPv4 TCP connections used to
fetch zones transferred inbound by the server. It also determines fetch zones transferred inbound by the server. It also determines
the IPv4 address, and optionaly the UDP port, used for the refresh queries, the source IPv4 address, and optionally the UDP port, used for the
notify messages and when updates are forwarded. If not set, it defaults refresh queries and forwarded dynamic updates. If not set, it defaults
to a system controlled value which will usually be the address of to a system controlled value which will usually be the address of
the interface "closest to" the remote end. This address must appear the interface "closest to" the remote end. This address must appear
in the remote end's <command>allow-transfer</command> option for in the remote end's <command>allow-transfer</command> option for
the zone being transferred, if one is specified. This statement the zone being transferred, if one is specified. This statement
sets the <command>transfer-source</command> for all zones, but can sets the <command>transfer-source</command> for all zones, but can
be overridden on a per-zone basis by including a be overridden on a per-view or per-zone basis by including a
<command>transfer-source</command> statement within the <command>zone</command> block <command>transfer-source</command> statement within the
<command>view</command> or <command>zone</command> block
in the configuration file.</para></entry> in the configuration file.</para></entry>
</row> </row>
<row rowsep = "0"> <row rowsep = "0">
@ -3130,21 +3131,19 @@ except zone transfers are performed using IPv6.</para></entry>
<row rowsep = "0"> <row rowsep = "0">
<entry colname = "1"><para><command>notify-source</command></para></entry> <entry colname = "1"><para><command>notify-source</command></para></entry>
<entry colname = "2"><para><command>notify-source</command> determines <entry colname = "2"><para><command>notify-source</command> determines
which local address and optionally UDP port, will be used to send NOTIFY which local source address, and optionally UDP port, will be used to
messages. If a <command>notify-source</command> is not specified then send NOTIFY messages.
then the <command>transfer-source</command> will be used and if that This address must appear in the slave server's <command>masters</command>
is not specified the <command>query-source</command> will be use.
This address must appear in the remote end's <command>masters</command>
zone clause. zone clause.
This statement sets the <command>notify-source</command> for all zones, This statement sets the <command>notify-source</command> for all zones,
but can be overridden on a per-zone / per-view basis by including a but can be overridden on a per-zone / per-view basis by including a
<command>notify-source</command> statement within the <command>zone</command> <command>notify-source</command> statement within the <command>zone</command>
/ <command>view</command> blocks in the configuration file.</para></entry> or <command>view</command> block in the configuration file.</para></entry>
</row> </row>
<row rowsep = "0"> <row rowsep = "0">
<entry colname = "1"><para><command>notify-source-v6</command></para></entry> <entry colname = "1"><para><command>notify-source-v6</command></para></entry>
<entry colname = "2"><para>The same as <command>notify-source</command>, <entry colname = "2"><para>Like <command>notify-source</command>,
except notify messages are sent using IPv6.</para></entry> but applies to notify messages sent to IPv6 addresses.</para></entry>
</row> </row>
</tbody> </tbody>
</tgroup> </tgroup>
@ -3834,7 +3833,7 @@ rbt or rbt64.
<row rowsep = "0"> <row rowsep = "0">
<entry colname = "1"><para><command>dialup</command></para></entry> <entry colname = "1"><para><command>dialup</command></para></entry>
<entry colname = "2"><para>See the description of <entry colname = "2"><para>See the description of
<command>dialup</command> under <xref linkend="boolean_options"/>.</para></entry> <command>dialup</command> in <xref linkend="boolean_options"/>.</para></entry>
</row> </row>
<row rowsep = "0"> <row rowsep = "0">
<entry colname = "1"><para><command>forward</command></para></entry> <entry colname = "1"><para><command>forward</command></para></entry>
@ -3862,27 +3861,27 @@ zone file.</para></entry>
<row rowsep = "0"> <row rowsep = "0">
<entry colname = "1"><para><command>max-transfer-time-in</command></para></entry> <entry colname = "1"><para><command>max-transfer-time-in</command></para></entry>
<entry colname = "2"><para>See the description of <entry colname = "2"><para>See the description of
<command>max-transfer-time-in</command> under <xref linkend="zone_transfers"/>.</para></entry> <command>max-transfer-time-in</command> in <xref linkend="zone_transfers"/>.</para></entry>
</row> </row>
<row rowsep = "0"> <row rowsep = "0">
<entry colname = "1"><para><command>max-transfer-idle-in</command></para></entry> <entry colname = "1"><para><command>max-transfer-idle-in</command></para></entry>
<entry colname = "2"><para>See the description of <entry colname = "2"><para>See the description of
<command>max-transfer-idle-in</command> under <xref linkend="zone_transfers"/>.</para></entry> <command>max-transfer-idle-in</command> in <xref linkend="zone_transfers"/>.</para></entry>
</row> </row>
<row rowsep = "0"> <row rowsep = "0">
<entry colname = "1"><para><command>max-transfer-time-out</command></para></entry> <entry colname = "1"><para><command>max-transfer-time-out</command></para></entry>
<entry colname = "2"><para>See the description of <entry colname = "2"><para>See the description of
<command>max-transfer-time-out</command> under <xref linkend="zone_transfers"/>.</para></entry> <command>max-transfer-time-out</command> in <xref linkend="zone_transfers"/>.</para></entry>
</row> </row>
<row rowsep = "0"> <row rowsep = "0">
<entry colname = "1"><para><command>max-transfer-idle-out</command></para></entry> <entry colname = "1"><para><command>max-transfer-idle-out</command></para></entry>
<entry colname = "2"><para>See the description of <entry colname = "2"><para>See the description of
<command>max-transfer-idle-out</command> under <xref linkend="zone_transfers"/>.</para></entry> <command>max-transfer-idle-out</command> in <xref linkend="zone_transfers"/>.</para></entry>
</row> </row>
<row rowsep = "0"> <row rowsep = "0">
<entry colname = "1"><para><command>notify</command></para></entry> <entry colname = "1"><para><command>notify</command></para></entry>
<entry colname = "2"><para>See the description of <entry colname = "2"><para>See the description of
<command>notify</command> under <xref linkend="boolean_options"/>.</para></entry> <command>notify</command> in <xref linkend="boolean_options"/>.</para></entry>
</row> </row>
<row rowsep = "0"> <row rowsep = "0">
<entry colname = "1"><para><command>pubkey</command></para></entry> <entry colname = "1"><para><command>pubkey</command></para></entry>
@ -3900,40 +3899,31 @@ information for this zone, which can be dumped to the
<row rowsep = "0"> <row rowsep = "0">
<entry colname = "1"><para><command>sig-validity-interval</command></para></entry> <entry colname = "1"><para><command>sig-validity-interval</command></para></entry>
<entry colname = "2"><para>See the description of <entry colname = "2"><para>See the description of
<command>sig-validity-interval</command> under <xref linkend="tuning"/>.</para></entry> <command>sig-validity-interval</command> in <xref linkend="tuning"/>.</para></entry>
</row> </row>
<row rowsep = "0"> <row rowsep = "0">
<entry colname = "1"><para><command>transfer-source</command></para></entry> <entry colname = "1"><para><command>transfer-source</command></para></entry>
<entry colname = "2"><para>Determines which local address will be bound <entry colname = "2"><para>See the description of
to the IPv4 TCP connection used to fetch this zone. It also determines <command>transfer-source</command> in <xref linkend="zone_transfers"/>
the IPv4 address, and optionaly the UDP port, used for the refresh queries, </para></entry>
notify messages and when updates are forwarded. If not set,
it defaults to a system controlled value which will usually be the
address of the interface "closest to" the remote end. If the remote
end user is an <command>allow-transfer</command> option for this
zone, the address, supplied by the <command>transfer-source</command> option,
needs to be specified in that <command>allow-transfer</command> option.</para></entry>
</row> </row>
<row rowsep = "0"> <row rowsep = "0">
<entry colname = "1"><para>transfer-source-v6</para></entry> <entry colname = "1"><para><command>transfer-source-v6</command></para></entry>
<entry colname = "2"><para>Similar to transfer-source, but for zone transfers <entry colname = "2"><para>See the description of
performed using IPv6.</para></entry> <command>transfer-source-v6</command> in <xref linkend="zone_transfers"/>
</para></entry>
</row> </row>
<row rowsep = "0"> <row rowsep = "0">
<entry colname = "1"><para><command>notify-source</command></para></entry> <entry colname = "1"><para><command>notify-source</command></para></entry>
<entry colname = "2"><para><command>notify-source</command> determines <entry colname = "2"><para>See the description of
which local address, and optionally UDP port, will be used to send NOTIFY <command>notify-source</command> in <xref linkend="zone_transfers"/>
messages. If a <command>notify-source</command> is not specified then </para></entry>
then the <command>transfer-source</command> will be used, if neither
of these are set then the address and port used will be determined by
the <command>view</command> then the <command>options</command> blocks.
This address must appear in the remote end's <command>masters</command>
zone clause.</para></entry>
</row> </row>
<row rowsep = "0"> <row rowsep = "0">
<entry colname = "1"><para>notify-source-v6</para></entry> <entry colname = "1"><para><command>notify-source-v6</command></para></entry>
<entry colname = "2"><para>Similar to notify-source, but notify messages <entry colname = "2"><para>See the description of
are sent using IPv6.</para></entry> <command>notify-source-v6</command> in <xref linkend="zone_transfers"/>.
</para></entry>
</row> </row>
</tbody> </tbody>
</tgroup></informaltable></sect3> </tgroup></informaltable></sect3>