master.html revision 9bff67898d55cddfcec9ce30cc2b1bb6211ec691
983deb7c242cc1e46040395a8e31d949c8cd6508Andi Egloff<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
47196c962e3caf7cdf7ea5d00ccdefc9f208bdceLaszlo Hordos<!--
983deb7c242cc1e46040395a8e31d949c8cd6508Andi Egloff - Copyright (C) 1999, 2000 Internet Software Consortium.
47196c962e3caf7cdf7ea5d00ccdefc9f208bdceLaszlo Hordos -
983deb7c242cc1e46040395a8e31d949c8cd6508Andi Egloff - Permission to use, copy, modify, and distribute this software for any
47196c962e3caf7cdf7ea5d00ccdefc9f208bdceLaszlo Hordos - purpose with or without fee is hereby granted, provided that the above
47196c962e3caf7cdf7ea5d00ccdefc9f208bdceLaszlo Hordos - copyright notice and this permission notice appear in all copies.
47196c962e3caf7cdf7ea5d00ccdefc9f208bdceLaszlo Hordos -
47196c962e3caf7cdf7ea5d00ccdefc9f208bdceLaszlo Hordos - THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM DISCLAIMS
983deb7c242cc1e46040395a8e31d949c8cd6508Andi Egloff - ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES
47196c962e3caf7cdf7ea5d00ccdefc9f208bdceLaszlo Hordos - OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL INTERNET SOFTWARE
47196c962e3caf7cdf7ea5d00ccdefc9f208bdceLaszlo Hordos - CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
47196c962e3caf7cdf7ea5d00ccdefc9f208bdceLaszlo Hordos - DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
47196c962e3caf7cdf7ea5d00ccdefc9f208bdceLaszlo Hordos - PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
47196c962e3caf7cdf7ea5d00ccdefc9f208bdceLaszlo Hordos - ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
47196c962e3caf7cdf7ea5d00ccdefc9f208bdceLaszlo Hordos - SOFTWARE.
47196c962e3caf7cdf7ea5d00ccdefc9f208bdceLaszlo Hordos-->
47196c962e3caf7cdf7ea5d00ccdefc9f208bdceLaszlo Hordos
47196c962e3caf7cdf7ea5d00ccdefc9f208bdceLaszlo Hordos<HTML>
47196c962e3caf7cdf7ea5d00ccdefc9f208bdceLaszlo Hordos<HEAD>
47196c962e3caf7cdf7ea5d00ccdefc9f208bdceLaszlo Hordos <TITLE>Master File Format</TITLE>
47196c962e3caf7cdf7ea5d00ccdefc9f208bdceLaszlo Hordos</HEAD>
983deb7c242cc1e46040395a8e31d949c8cd6508Andi Egloff
983deb7c242cc1e46040395a8e31d949c8cd6508Andi Egloff<BODY>
983deb7c242cc1e46040395a8e31d949c8cd6508Andi Egloff<H2>BIND Configuration Guide -- Master File Format</H2>
983deb7c242cc1e46040395a8e31d949c8cd6508Andi Egloff
983deb7c242cc1e46040395a8e31d949c8cd6508Andi Egloff<HR>
f56ff38befd2d32c4d47af7794303ee7c3a36f94Andi Egloff
983deb7c242cc1e46040395a8e31d949c8cd6508Andi Egloff<P>
983deb7c242cc1e46040395a8e31d949c8cd6508Andi EgloffThe Master File Format was initially defined in
47196c962e3caf7cdf7ea5d00ccdefc9f208bdceLaszlo Hordos<A HREF=http://ds.internic.net/rfc/rfc1035.txt>RFC 1035</A>
47196c962e3caf7cdf7ea5d00ccdefc9f208bdceLaszlo Hordosand has subsequently been extended.
47196c962e3caf7cdf7ea5d00ccdefc9f208bdceLaszlo Hordos<P>
983deb7c242cc1e46040395a8e31d949c8cd6508Andi EgloffWhile the Master File Format is class independent all records in a
983deb7c242cc1e46040395a8e31d949c8cd6508Andi EgloffMaster File must be of the same class.
983deb7c242cc1e46040395a8e31d949c8cd6508Andi Egloff
983deb7c242cc1e46040395a8e31d949c8cd6508Andi Egloff<H3>Master File Directives</H3>
d0840514601c4eea1672996b07b27ca61bd4197dLaszlo Hordos<H4>$ORIGIN</H4>
983deb7c242cc1e46040395a8e31d949c8cd6508Andi EgloffSyntax: <CODE>$ORIGIN &lt;domain-name&gt; [&lt;comment&gt;]</CODE>
983deb7c242cc1e46040395a8e31d949c8cd6508Andi Egloff<P>
47196c962e3caf7cdf7ea5d00ccdefc9f208bdceLaszlo Hordos<CODE>$ORIGIN</CODE> set the domain name that will be appended to any
983deb7c242cc1e46040395a8e31d949c8cd6508Andi Egloffunqualified records.
47196c962e3caf7cdf7ea5d00ccdefc9f208bdceLaszlo HordosWhen a zone is first read in there is an implict <CODE>$ORIGIN</CODE>
47196c962e3caf7cdf7ea5d00ccdefc9f208bdceLaszlo Hordos&lt;zone-name&gt;.
47196c962e3caf7cdf7ea5d00ccdefc9f208bdceLaszlo HordosThe current <CODE>$ORIGIN</CODE> is appended to the domain specified in the
47196c962e3caf7cdf7ea5d00ccdefc9f208bdceLaszlo Hordos<CODE>$ORIGIN</CODE> argument if it is not absolute.
47196c962e3caf7cdf7ea5d00ccdefc9f208bdceLaszlo Hordos
d0840514601c4eea1672996b07b27ca61bd4197dLaszlo Hordos<PRE>
983deb7c242cc1e46040395a8e31d949c8cd6508Andi Egloff$ORIGIN EXAMPLE.
983deb7c242cc1e46040395a8e31d949c8cd6508Andi Egloff$ORIGIN MYZONE
983deb7c242cc1e46040395a8e31d949c8cd6508Andi EgloffWWW CNAME MAIN-SERVER
983deb7c242cc1e46040395a8e31d949c8cd6508Andi Egloff</PRE>
983deb7c242cc1e46040395a8e31d949c8cd6508Andi Egloffis equivlent to
983deb7c242cc1e46040395a8e31d949c8cd6508Andi Egloff<PRE>
983deb7c242cc1e46040395a8e31d949c8cd6508Andi EgloffWWW.MYZONE.EXAMPLE. CNAME MAIN-SERVER.MYZONE.EXAMPLE.
983deb7c242cc1e46040395a8e31d949c8cd6508Andi Egloff</PRE>
<H4>$INCLUDE</H4>
Syntax: <CODE>$INCLUDE &lt;filename&gt; [&lt;origin&gt;] [&lt;comment&gt;]</CODE>
<P>
Read and process the file filename as if it was included into the file at this
point.� If origin is specified the file is processed with <CODE>$ORIGIN</CODE>
set to that value otherwise the current <CODE>$ORIGIN</CODE> is used.
<I>NOTE: The behaviour when &lt;origin&gt; is specified differs from that
described in
<A HREF=http://ds.internic.net/rfc/rfc1035.txt>RFC 1035</A>.</I>
<P>
The origin and current domain revert to the values they were prior to the
<CODE>$INCLUDE</CODE> once the file has been read.
<H4>$TTL</H4>
Syntax: <CODE>$TTL &lt;default-ttl&gt; [&lt;comment&gt;]</CODE>
<P>
Set the default Time To Live (TTL) for subsequent records with undefined
TTL's. Valid TTL's are of the range 0-2147483647.
<P>
<CODE>$TTL</CODE> is defined in
<A HREF=http://ds.internic.net/rfc/rfc2308.txt>RFC 2308</A>.
<H3>BIND Master File Extentions</H3>
<H4>$GENERATE</H4>
Syntax: <CODE>$GENERATE &lt;range&gt; &lt;lhs&gt; &lt;type&gt; &lt;rhs&gt;
[&lt;comment&gt;]</CODE>
<P>
<CODE>$GENERATE</CODE> is used to create a series of resource records
that only differ from each other by an iterator. <CODE>$GENERATE</CODE>
can be used to easily generate the sets of records required to support
sub /24 reverse delegations described in
<A HREF=http://ds.internic.net/rfc/rfc2317.txt>RFC 2317: Classless IN-ADDR.ARPA delegation</A>.
<PRE>
$ORIGIN 0.0.192.IN-ADDR.ARPA.
$GENERATE 1-2 0 NS SERVER$.EXAMPLE.
$GENERATE 1-127 $ CNAME $.0
</PRE>
is equivalent to
<PRE>
0.0.0.192.IN-ADDR.ARPA NS SERVER1.EXAMPLE.
0.0.0.192.IN-ADDR.ARPA NS SERVER2.EXAMPLE.
1.0.0.192.IN-ADDR.ARPA CNAME 1.0.0.0.192.IN-ADDR.ARPA
2.0.0.192.IN-ADDR.ARPA CNAME 2.0.0.0.192.IN-ADDR.ARPA
...
127.0.0.192.IN-ADDR.ARPA CNAME 127.0.0.0.192.IN-ADDR.ARPA
</PRE>
<DL>
<DT>range</DT>
<DD>
This can be one of two forms:
<I>start</I>-<I>stop</I>
or
<I>start</I>-<I>stop</I>/<I>step</I>. If the first form is
used then step is set to 1. All of start, stop and step must be positive.
<DT>lhs</DT>
<DD>
Lhs describes the owner name of the resource records to be created.
Any single $ symbols within the LHS side are replaced by the iterator value.
To get a $ in the output use a double $, e.g. $$. If the lhs is not absolute
the current $ORIGIN is appended to the name.
<DT>type</DT>
<DD>
At present the only supported types are PTR, CNAME and NS.
<DT>rhs</DT>
<DD>
Rhs is a domain name. It is processed similarly to the lhs.
<DD>
</DL>
<H2>Resource Records</H2>
Syntax: <CODE>{&lt;domain&gt;|@|&lt;blank&gt;}
[&lt;ttl&gt;] [&lt;class&gt;] &lt;type&gt; &lt;rdata&gt;
[&lt;comment&gt;]</CODE>
<P>
All resource records have the same basic syntax.
<DL>
<DT><CODE>domain</CODE></DT>
<DD>
Specify the domain name for this record. If it is not absolute the
current <CODE>$ORIGIN</CODE> is appended.
<DT><CODE>@</CODE></DT>
<DD>
Use the current <CODE>$ORIGIN</CODE> for the domain name for this record.
<DT><CODE>blank</CODE></DT>
<DD>
Use the last specified domainname.
<DT><CODE>ttl</CODE></DT>
<DD>
This specifies how long this record will be cached by caching servers.
The valid range is 0-2147483647.
<DT><CODE>class</CODE></DT>
<DD>
Specify the class of this record. This is usually redundent as the
class of a zone is specfied in the configuration file prior to reading
the zone file.
<DT><CODE>type</CODE></DT>
<DD>
Specify the type of this record. This describes the contents of the rdata
section.
<DT><CODE>rdata</CODE></DT>
<DD>
This is the value of the resource record.
</DL>
</BODY>
</HTML>