<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML>
<HEAD>
  <TITLE>BIND zone Statement</TITLE>
</HEAD>

<BODY>
<H2>BIND Configuration File Guide--<CODE>zone</CODE> Statement</H2>

<HR>

<A NAME="Syntax"><H3>Syntax</H3></A>

<PRE>
zone <VAR><A HREF="docdef.html">domain_name</A></VAR> [ ( in | hs | hesiod | chaos ) ] { 
  type master;
  file <VAR><A HREF="docdef.html">path_name</A></VAR>;
  [ check-names ( warn | fail | ignore ); ]
  [ allow-update { <VAR><A NAME="address_list.html">address_match_list</A></VAR> }; ]
  [ allow-query { <VAR><A NAME="address_list.html">address_match_list</A></VAR> }; ]
  [ allow-transfer { <VAR><A NAME="address_list.html">address_match_list</A></VAR> }; ]
  [ notify <VAR><A HREF="docdef.html">yes_or_no</A></VAR>; ]
  [ also-notify { <VAR><A HREF="docdef.html">ip_addr</A></VAR>; [ <VAR>ip_addr</VAR>; ... ] };
};

zone <VAR><A HREF="docdef.html">domain_name</A></VAR> [ ( in | hs | hesiod | chaos ) ] { 
  type ( slave | stub );
  [ file <VAR><A HREF="docdef.html">path_name</A></VAR>; ]
  masters { <VAR><A HREF="docdef.html">ip_addr</A></VAR>; [ <VAR>ip_addr</VAR>; ... ] };
  [ check-names ( warn | fail | ignore ); ]
  [ allow-update { <VAR><A NAME="address_list.html">address_match_list</A></VAR> }; ]
  [ allow-query { <VAR><A NAME="address_list.html">address_match_list</A></VAR> }; ]
  [ allow-transfer { <VAR><A NAME="address_list.html">address_match_list</A></VAR> }; ]
  [ max-transfer-time-in <VAR>number</VAR>; ]
  [ notify <VAR><A HREF="docdef.html">yes_or_no</A></VAR>; ]
  [ also-notify { <VAR><A HREF="docdef.html">ip_addr</A></VAR>; [ <VAR>ip_addr</VAR>; ... ] };
};

zone "." [ ( in | hs | hesiod | chaos ) ] { 
  type hint;
  file <VAR><A HREF="docdef.html">path_name</A></VAR>;
  [ check-names ( warn | fail | ignore ); ]
};
</PRE>

<HR>

<A NAME="Usage"><H3>Definition and Usage</H3></A>

<H4>Zone Types</H4>

<DL>
<DT><CODE>master</CODE>
<DD>
The master copy of the data in a zone.

<DT><CODE>slave</CODE>
<DD>
A <CODE>slave</CODE> zone is a replica of a master zone.  The
<CODE>masters</CODE> list specifies one or more IP addresses that the
slave contacts to update its copy of the zone.  If <CODE>file</CODE>
is specified, then the replica will be written to the file.  Use of
<CODE>file</CODE> is recommended, since it often speeds server startup
and eliminates a needless waste of bandwidth.

<DT><CODE>stub</CODE>
<DD>
A <CODE>stub</CODE> zone is like a slave zone, except that it replicates
only the NS records of a master zone instead of the entire zone.

<DT><CODE>hint</CODE>
<DD>
The initial set of root nameservers is specified using a
<CODE>hint</CODE> zone.  When the server starts up, it uses the root hints
to find a root nameserver and get the most recent list of root nameservers.
</DL>

<P>Note: previous releases of BIND used the term <EM>primary</EM> for a
master zone, <EM>secondary</EM> for a slave zone, and <EM>cache</EM> for
a hint zone.</P>

<H4>Class</H4>

<P>The zone's name may optionally be followed by a class.  If a class is not
specified, class <CODE>in</CODE> is used.

<H4>Options</H4>

<DL>
<DT><CODE>check-names</CODE>
<DD>
See <A HREF="options.html#NameChecking">Name Checking</A>.

<DT><CODE>allow-query</CODE>
<DD>
See the description of <CODE>allow-query</CODE> in the
<A HREF="options.html#AccessControl">Access Control</A> section.

<DT><CODE>allow-update</CODE>
<DD>
Specifies which hosts are allowed to submit Dynamic DNS updates to the
server.  The default is to deny updates from all hosts.

<DT><CODE>allow-transfer</CODE>
<DD>
See the description of <CODE>allow-transfer</CODE> in
the <A HREF="options.html#AccessControl">Access Control</A> section.

<DT><CODE>max-transfer-time-in</CODE>
<DD>
See the description of <CODE>max-transfer-time-in</CODE> in
the <A HREF="options.html#ZoneTransfers">Zone Transfers</A> section.

<DT><CODE>notify</CODE>
<DD>
See the description of <CODE>notify</CODE> in
the <A HREF="options.html#BooleanOptions">Boolean Options</A> section.

<DT><CODE>also-notify</CODE>
<DD>
<CODE>also-notify</CODE> is only meaningful if <CODE>notify</CODE> is
active for this zone.  The set of machines that will receive a DNS
NOTIFY message for this zone is made up of all the listed nameservers
for the zone (other than the primary master) plus any IP addresses
specified with <CODE>also-notify</CODE>.  <CODE>also-notify</CODE> is not
meaningful for <CODE>stub</CODE> zones.  The default is the empty list.
</DL>

<HR>

<CENTER><P>[ <A HREF="config.html">BIND Config. File</A>
| <A HREF="http://www.vix.com/isc/bind.html">BIND Home</A>
| <A HREF="http://www.isc.org">ISC</A> ]</P></CENTER>

<HR>
<ADDRESS>
Last Updated: $Id: zone.html,v 1.6 1998/03/21 01:03:14 halley Exp $
</ADDRESS>
</BODY>
</HTML>
