freebsd-dev/contrib/bind/doc/html/zone.html

141 lines
4.6 KiB
HTML
Raw Normal View History

<!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>