zone.html revision 9bff67898d55cddfcec9ce30cc2b1bb6211ec691
d6fa26d0adaec6c910115be34fe7a5a5f402c14fMark Andrews<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
33d0a7767d53cb366039fd0ac4f63cf8a9c351b0Tinderbox User - Copyright (C) 1999, 2000 Internet Software Consortium.
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - Permission to use, copy, modify, and distribute this software for any
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - purpose with or without fee is hereby granted, provided that the above
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - copyright notice and this permission notice appear in all copies.
d6fa26d0adaec6c910115be34fe7a5a5f402c14fMark Andrews - THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM DISCLAIMS
351b62535d4c4f89883bfdba025999dd32490266Evan Hunt - ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES
351b62535d4c4f89883bfdba025999dd32490266Evan Hunt - OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL INTERNET SOFTWARE
351b62535d4c4f89883bfdba025999dd32490266Evan Hunt - CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User - DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
351b62535d4c4f89883bfdba025999dd32490266Evan Hunt - PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User - ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<H2>BIND Configuration File Guide--<CODE>zone</CODE> Statement</H2>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox Userzone <VAR><A HREF="docdef.html">domain_name</A></VAR> [ ( in | hs | hesiod | chaos ) ] {
351b62535d4c4f89883bfdba025999dd32490266Evan Hunt type master;
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User file <VAR><A HREF="docdef.html">path_name</A></VAR>;
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User [ forward ( only | first ); ]
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User [ forwarders { [ <VAR><A HREF="docdef.html">ip_addr</A></VAR> ; [ <VAR>ip_addr</VAR> ; ... ] ] }; ]
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User [ check-names ( warn | fail | ignore ); ]
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User [ allow-update { <VAR><A HREF="address_list.html">address_match_list</A></VAR> }; ]
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User [ allow-query { <VAR><A HREF="address_list.html">address_match_list</A></VAR> }; ]
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User [ allow-transfer { <VAR><A HREF="address_list.html">address_match_list</A></VAR> }; ]
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User [ dialup <VAR><A HREF="docdef.html">yes_or_no</A></VAR>; ]
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User [ notify <VAR><A HREF="docdef.html">yes_or_no</A></VAR>; ]
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User [ also-notify { <VAR><A HREF="docdef.html">ip_addr</A></VAR>; [ <VAR>ip_addr</VAR>; ... ] };
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User [ ixfr-base <VAR><A HREF="docdef.html">path_name</A></VAR>; ]
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User [ pubkey <VAR><A HREF="docdef.html">number</A></VAR> <VAR><A HREF="docdef.html">number</A></VAR> <VAR><A HREF="docdef.html">number</A></VAR> <VAR>string</VAR>; ]
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox Userzone <VAR><A HREF="docdef.html">domain_name</A></VAR> [ ( in | hs | hesiod | chaos ) ] {
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User [ file <VAR><A HREF="docdef.html">path_name</A></VAR>; ]
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User [ ixfr-base <VAR><A HREF="docdef.html">path_name</A></VAR>; ]
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User masters [ port <VAR><A HREF="docdef.html">ip_port</A></VAR> ] { <VAR><A HREF="docdef.html">ip_addr</A></VAR>; [ <VAR>ip_addr</VAR>; ... ] };
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User [ forward ( only | first ); ]
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User [ forwarders { [ <VAR><A HREF="docdef.html">ip_addr</A></VAR> ; [ <VAR>ip_addr</VAR> ; ... ] ] }; ]
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User [ check-names ( warn | fail | ignore ); ]
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User [ allow-update { <VAR><A HREF="address_list.html">address_match_list</A></VAR> }; ]
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User [ allow-query { <VAR><A HREF="address_list.html">address_match_list</A></VAR> }; ]
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User [ allow-transfer { <VAR><A HREF="address_list.html">address_match_list</A></VAR> }; ]
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User [ transfer-source <VAR><A HREF="docdef.html">ip_addr</A></VAR>; ]
ec899c963c91c16c393e067996400ae244921110Tinderbox User [ dialup <VAR><A HREF="docdef.html">yes_or_no</A></VAR>; ]
ec899c963c91c16c393e067996400ae244921110Tinderbox User [ notify <VAR><A HREF="docdef.html">yes_or_no</A></VAR>; ]
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User [ also-notify { <VAR><A HREF="docdef.html">ip_addr</A></VAR>; [ <VAR>ip_addr</VAR>; ... ] };
ec899c963c91c16c393e067996400ae244921110Tinderbox User [ pubkey <VAR><A HREF="docdef.html">number</A></VAR> <VAR><A HREF="docdef.html">number</A></VAR> <VAR><A HREF="docdef.html">number</A></VAR> <VAR>string</VAR>; ]
ec899c963c91c16c393e067996400ae244921110Tinderbox Userzone <VAR><A HREF="docdef.html">domain_name</A></VAR> [ ( in | hs | hesiod | chaos ) ] {
ec899c963c91c16c393e067996400ae244921110Tinderbox User [ file <VAR><A HREF="docdef.html">path_name</A></VAR>; ]
351b62535d4c4f89883bfdba025999dd32490266Evan Hunt masters [ port <VAR><A HREF="docdef.html">ip_port</A></VAR> ] { <VAR><A HREF="docdef.html">ip_addr</A></VAR>; [ <VAR>ip_addr</VAR>; ... ] };
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User [ forward ( only | first ); ]
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User [ forwarders { [ <VAR><A HREF="docdef.html">ip_addr</A></VAR> ; [ <VAR>ip_addr</VAR> ; ... ] ] }; ]
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User [ check-names ( warn | fail | ignore ); ]
ec899c963c91c16c393e067996400ae244921110Tinderbox User [ allow-update { <VAR><A HREF="address_list.html">address_match_list</A></VAR> }; ]
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User [ allow-query { <VAR><A HREF="address_list.html">address_match_list</A></VAR> }; ]
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User [ allow-transfer { <VAR><A HREF="address_list.html">address_match_list</A></VAR> }; ]
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User [ dialup <VAR><A HREF="docdef.html">yes_or_no</A></VAR>; ]
ec899c963c91c16c393e067996400ae244921110Tinderbox User [ transfer-source <VAR><A HREF="docdef.html">ip_addr</A></VAR>; ]
ec899c963c91c16c393e067996400ae244921110Tinderbox User [ pubkey <VAR><A HREF="docdef.html">number</A></VAR> <VAR><A HREF="docdef.html">number</A></VAR> <VAR><A HREF="docdef.html">number</A></VAR> <VAR>string</VAR>; ]
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox Userzone <VAR><A HREF="docdef.html">domain_name</A></VAR> [ ( in | hs | hesiod | chaos ) ] {
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User type forward;
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User [ forward ( only | first ); ]
ec899c963c91c16c393e067996400ae244921110Tinderbox User [ forwarders { [ <VAR><A HREF="docdef.html">ip_addr</A></VAR> ; [ <VAR>ip_addr</VAR> ; ... ] ] }; ]
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User [ check-names ( warn | fail | ignore ); ]
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox Userzone "." [ ( in | hs | hesiod | chaos ) ] {
351b62535d4c4f89883bfdba025999dd32490266Evan Hunt file <VAR><A HREF="docdef.html">path_name</A></VAR>;
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User [ check-names ( warn | fail | ignore ); ]
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<A NAME="Usage"><H3>Definition and Usage</H3></A>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox UserThe <CODE>type</CODE> statement must come first in the body of the
351b62535d4c4f89883bfdba025999dd32490266Evan Huntzone statement.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox UserThe server has a master copy of the data for the zone and will be able
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox Userto provide authoritative answers for it.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox UserA <CODE>slave</CODE> zone is a replica of a master zone. The
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<CODE>masters</CODE> list specifies one or more IP addresses that the
351b62535d4c4f89883bfdba025999dd32490266Evan Huntslave contacts to update its copy of the zone. If a <CODE>port</CODE>
7ae7246a6339bb3a79ffc9f2f9c486de9a2bf65eAutomatic Updateris specified then checks to see if the zone is current and zone transfers
2cbb4ab75757fbb656997a82c14ca07db37d481aAutomatic Updaterwill be done to the port given. If <CODE>file</CODE>
7ae7246a6339bb3a79ffc9f2f9c486de9a2bf65eAutomatic Updateris specified, then the replica will be written to this file whenever
7ae7246a6339bb3a79ffc9f2f9c486de9a2bf65eAutomatic Updaterthe zone is changed, and reloaded from this file on a server restart.
7ae7246a6339bb3a79ffc9f2f9c486de9a2bf65eAutomatic Updater<CODE>file</CODE> is recommended, since it often speeds server startup
351b62535d4c4f89883bfdba025999dd32490266Evan Huntand eliminates a needless waste of bandwidth. Note that for large numbers
351b62535d4c4f89883bfdba025999dd32490266Evan Hunt(in the tens or hundreds of thousands) of zones per server, it is best to
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox Useruse a two level naming scheme for zone file names. For example, a slave
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox Userserver for the zone <CODE>vix.com</CODE> might place the zone contents into
351b62535d4c4f89883bfdba025999dd32490266Evan Hunta file called <CODE>"vi/vix.com"</CODE> where <CODE>vi/</CODE> is just the
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox Userfirst two letters of the zone name. (Most operating systems behave very
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox Userslowly if you put 100K files into a single directory.)
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox UserA <CODE>stub</CODE> zone is like a slave zone, except that it replicates
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox Useronly the NS records of a master zone instead of the entire zone.
351b62535d4c4f89883bfdba025999dd32490266Evan HuntA <CODE>forward</CODE> zone is used to <A HREF="options.html#Forwarding">
351b62535d4c4f89883bfdba025999dd32490266Evan Huntdirect all queries</A> in it to other servers. The specification of
351b62535d4c4f89883bfdba025999dd32490266Evan Huntoptions in such a zone will override any global options
351b62535d4c4f89883bfdba025999dd32490266Evan Huntdeclared in the <A HREF="options.html#Forwarding">options</A> statement.
351b62535d4c4f89883bfdba025999dd32490266Evan Hunt<P>If either no <CODE>forwarders</CODE> statement is present in the
351b62535d4c4f89883bfdba025999dd32490266Evan Huntzone or an empty list for <CODE>forwarders</CODE> is given, then no
351b62535d4c4f89883bfdba025999dd32490266Evan Huntforwarding will be done for the zone, cancelling the effects of any
351b62535d4c4f89883bfdba025999dd32490266Evan Hunt<CODE>forwarders</CODE> in the <CODE>options</CODE> statement.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox UserThus if you want to use this
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox Usertype of zone to change the behavior of the global <CODE>forward</CODE>
7ae7246a6339bb3a79ffc9f2f9c486de9a2bf65eAutomatic Updateroption, and not the servers used, then you also need to respecify the
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox Userglobal forwarders.
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox UserThe initial set of root nameservers is specified using a
ec899c963c91c16c393e067996400ae244921110Tinderbox User<CODE>hint</CODE> zone. When the server starts up, it uses the root hints
ec899c963c91c16c393e067996400ae244921110Tinderbox Userto find a root nameserver and get the most recent list of root nameservers.
2cbb4ab75757fbb656997a82c14ca07db37d481aAutomatic Updater<P>Note: previous releases of BIND used the term <EM>primary</EM> for a
2cbb4ab75757fbb656997a82c14ca07db37d481aAutomatic Updatermaster zone, <EM>secondary</EM> for a slave zone, and <EM>cache</EM> for
2cbb4ab75757fbb656997a82c14ca07db37d481aAutomatic Updatera hint zone.</P>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<P>The zone's name may optionally be followed by a class. If a class
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox Useris not specified, class <CODE>in</CODE> (for "internet"), is assumed.
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox UserThis is correct for the vast majority of cases.
2eeb74d1cf5355dd98f6d507a10086e16bb08c4bTinderbox User<P>The <CODE>hesiod</CODE> class is for an information service from MIT's
7ae7246a6339bb3a79ffc9f2f9c486de9a2bf65eAutomatic UpdaterProject Athena. It is used to share information about various systems
7ae7246a6339bb3a79ffc9f2f9c486de9a2bf65eAutomatic Updaterdatabases, such as users, groups, printers and so on. More
ec899c963c91c16c393e067996400ae244921110Tinderbox Userinformation can be found at
ec899c963c91c16c393e067996400ae244921110Tinderbox User<A HREF="ftp://athena-dist.mit.edu/pub/ATHENA/usenix/athena_changes.PS">MIT</A>.
ec899c963c91c16c393e067996400ae244921110Tinderbox UserThe keyword <CODE>hs</CODE> is a synonym for <CODE>hesiod</CODE>.</P>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<P>Another MIT development was CHAOSnet, a LAN protocol created in the
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox Usermid-1970s. It is still sometimes seen on LISP stations and other
351b62535d4c4f89883bfdba025999dd32490266Evan Hunthardware in the AI community, and zone data for it can be specified
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox UserSee <A HREF="options.html#NameChecking">Name Checking</A>.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox UserSee the description of <CODE>allow-query</CODE> in the
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<A HREF="options.html#AccessControl">Access Control</A> section.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox UserSpecifies which hosts are allowed to submit Dynamic DNS updates to the
351b62535d4c4f89883bfdba025999dd32490266Evan Huntserver. The default is to deny updates from all hosts.