config.html revision 15a44745412679c30a6d022733925af70a38b715
280a8a0544b4aeb52414d20e8c6e6c5b1108562eTinderbox User<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
59602f2a7c4e4809941583bed3e94cd26e628f1aTinderbox User<!--
6fe48fb46e53ffc37542853a1edb74cb481b7d94Automatic Updater - Copyright (C) 1999, 2000 Internet Software Consortium.
5affecff6e148a8e124d03f5dbac0da11e30dcc5Tinderbox User -
19558a04decde0e7261d489d92d04ad88104217bTinderbox User - Permission to use, copy, modify, and distribute this software for any
827f8cccb5280f4da66c46186e792d1cb9d73503Mark Andrews - purpose with or without fee is hereby granted, provided that the above
827f8cccb5280f4da66c46186e792d1cb9d73503Mark Andrews - copyright notice and this permission notice appear in all copies.
969eaf7df8ac651946f76b6631ff5db568c11ef6Tinderbox User -
03ebc228ee3725738b067b6bd7082a9a731822a1Tinderbox User - THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM
f4ee48be3994797a8332b86c101db4d7b54799ceTinderbox User - DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL
a2c370ca12bb0360ff7e969474ead3f788c65fffTinderbox User - IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL
8de3f14f1c300c3e1ed99084cc03485b42c92bf1Tinderbox User - INTERNET SOFTWARE CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT,
e5a6871cd0635ecdb2bf792316a2d8c53206f4b2Tinderbox User - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
950d203b64f512b85fcc093ee1e9e3e531a1aea3Tinderbox User - FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
b886b04d8d2b085cbf3e1bf4442dee87f43ba5e4Tinderbox User - NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
03ebc228ee3725738b067b6bd7082a9a731822a1Tinderbox User - WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
3759f10fc543747668b1ca4b4671f35b0dea8445Francis Dupont-->
e676a596869d8a80a644c99a848afb53d1c5975eMark Andrews
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews<HTML>
b91d11bfcc30b96f2c80f3a76d12e3dcc8597a68Mark Andrews<HEAD>
d5637bdbb931ff79fced3d4858d83212ea58ed15Tinderbox User <TITLE>BIND Configuration File Guide</TITLE>
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews</HEAD>
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews
3759f10fc543747668b1ca4b4671f35b0dea8445Francis Dupont<BODY>
d5637bdbb931ff79fced3d4858d83212ea58ed15Tinderbox User<H2>BIND Configuration File Guide</H2>
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User<HR>
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User<H3>Overview</H3>
e813f036c8251b6d9d2a72fa84f80c2c9d2795afMark Andrews
30370d905e9be3be7d9b947fd432bacecbb13bb9Evan Hunt<P>BIND 8 is much more configurable than previous release of BIND.
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsThere are entirely new areas of configuration, such as access control lists
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox Userand categorized logging. Many options that previously applied to all zones
efb0e886f18894a1d2489f1ad74ad14b579e11c7Mark Andrewscan now be used selectively. These features, plus a consideration of future
e813f036c8251b6d9d2a72fa84f80c2c9d2795afMark Andrewsconfiguration needs led to the creation of a new configuration file format.
30370d905e9be3be7d9b947fd432bacecbb13bb9Evan Hunt
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews<H3>The Configuration File</H3>
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews<H4><A HREF="example.html">Example Configuration</A></H4>
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User
e813f036c8251b6d9d2a72fa84f80c2c9d2795afMark Andrews<H4>Statements</H4>
30370d905e9be3be7d9b947fd432bacecbb13bb9Evan Hunt
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews<P>A BIND 8 configuration consists of statements and comments.
015055b6e23f5c08f6a5b34726f90b62597e9e45Tinderbox UserStatements end with a semicolon. Many statements contain a block of
03ebc228ee3725738b067b6bd7082a9a731822a1Tinderbox Usersubstatements, which are also terminated with a semicolon.</P>
aa9c561961e9d877946ebaa8795fa2be054ab7bfEvan Hunt
dc238a06bffa79de141ee7655765e2df91498a8aTinderbox User<P>The following statements are supported:
827f8cccb5280f4da66c46186e792d1cb9d73503Mark Andrews<DL>
aa9c561961e9d877946ebaa8795fa2be054ab7bfEvan Hunt<DT><CODE><A HREF="acl.html">acl</A></CODE>
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater<DD>
3759f10fc543747668b1ca4b4671f35b0dea8445Francis Dupontdefines a named IP address matching list, for access control and other uses
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater
aa9c561961e9d877946ebaa8795fa2be054ab7bfEvan Hunt<DT><CODE><A HREF="include.html">include</A></CODE>
dc238a06bffa79de141ee7655765e2df91498a8aTinderbox User<DD>
827f8cccb5280f4da66c46186e792d1cb9d73503Mark Andrewsincludes a file
aa9c561961e9d877946ebaa8795fa2be054ab7bfEvan Hunt
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User<DT><CODE><A HREF="key.html">key</A></CODE>
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater<DD>
3759f10fc543747668b1ca4b4671f35b0dea8445Francis Dupontspecifies key information for use in authentication and authorization
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews<DT><CODE><A HREF="logging.html">logging</A></CODE>
cdfc81e048bd34c1d628380247bda6b80a89e20eAutomatic Updater<DD>
e813f036c8251b6d9d2a72fa84f80c2c9d2795afMark Andrewsspecifies what the server logs, and where the log messages are sent
30370d905e9be3be7d9b947fd432bacecbb13bb9Evan Hunt
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews<DT><CODE><A HREF="options.html">options</A></CODE>
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews<DD>
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updatercontrols global server configuration options and sets defaults for other
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrewsstatements
e813f036c8251b6d9d2a72fa84f80c2c9d2795afMark Andrews
30370d905e9be3be7d9b947fd432bacecbb13bb9Evan Hunt<DT><CODE><A HREF="controls.html">controls</A></CODE>
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews<DD>
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updaterdeclares control channels to be used by the <VAR>ndc</VAR> utility
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews
eabc9c3c07cd956d3c436bd7614cb162dabdda76Mark Andrews<DT><CODE><A HREF="server.html">server</A></CODE>
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews<DD>
e813f036c8251b6d9d2a72fa84f80c2c9d2795afMark Andrewssets certain configuration options on a per-server basis
30370d905e9be3be7d9b947fd432bacecbb13bb9Evan Hunt
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews<DT><CODE><A HREF="trusted-keys.html">trusted-keys</A></CODE>
015055b6e23f5c08f6a5b34726f90b62597e9e45Tinderbox User<DD>
03ebc228ee3725738b067b6bd7082a9a731822a1Tinderbox Userdefines DNSSEC keys that are preconfigured into the server and implicitly
fec6e13f2d1e69fe1c2b8fac36f732f124cf5398Mark Andrewstrusted
b91d11bfcc30b96f2c80f3a76d12e3dcc8597a68Mark Andrews
b91d11bfcc30b96f2c80f3a76d12e3dcc8597a68Mark Andrews<DT><CODE><A HREF="zone.html">zone</A></CODE>
fec6e13f2d1e69fe1c2b8fac36f732f124cf5398Mark Andrews<DD>
2ae159b376dac23870d8005563c585acf85a4b5aEvan Huntdefines a zone
2ae159b376dac23870d8005563c585acf85a4b5aEvan Hunt</DL>
2ae159b376dac23870d8005563c585acf85a4b5aEvan Hunt
e813f036c8251b6d9d2a72fa84f80c2c9d2795afMark Andrews<P>The <CODE>logging</CODE> and <CODE>options</CODE> statements may only
30370d905e9be3be7d9b947fd432bacecbb13bb9Evan Huntoccur once per configuration.
2ae159b376dac23870d8005563c585acf85a4b5aEvan Hunt
7cc0a5d21ef046bfd630c4769943d896a7d7472cTinderbox User<H4>Comments</HR>
e76dfff967cfbe00f4d1540434832e4499a9cd83Tinderbox User
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark AndrewsThe BIND 8 <A HREF="comments.html">comment syntax</A> allows for
549c517e2ecad52bb1d32f08920e29d4e8cda71eTinderbox Usercomments to appear anywhere that whitespace may appear in a BIND
549c517e2ecad52bb1d32f08920e29d4e8cda71eTinderbox Userconfiguration file. To appeal to programmers of all kinds, they can
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrewsbe written in C, C++, or shell/perl constructs.
549c517e2ecad52bb1d32f08920e29d4e8cda71eTinderbox User
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews<H3>Converting from BIND 4.9.x</H3>
e40c4e4c17d4df338e2a7db0f84d8dbb3858964cTinderbox User
3bd8b5a8fb126e45c67ff53b68183c889cc27918Tinderbox User<P>BIND 4.9.x configuration files can be converted to the new format
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrewsby using <CODE>src/bin/named/named-bootconf.pl</CODE>, a perl script that
b91d11bfcc30b96f2c80f3a76d12e3dcc8597a68Mark Andrewsis part of the BIND 8.1 source kit.
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews
e40c4e4c17d4df338e2a7db0f84d8dbb3858964cTinderbox User<HR>
aef6cf0f147a5014d4891c9689b9f463399e16e7Tinderbox User
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews<CENTER><P>[ <A HREF="http://www.vix.com/isc/bind.html">BIND Home</A>
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User|&nbsp;<A HREF="http://www.isc.org">ISC</A> ]</P></CENTER>
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User<HR>
e813f036c8251b6d9d2a72fa84f80c2c9d2795afMark Andrews<ADDRESS>
30370d905e9be3be7d9b947fd432bacecbb13bb9Evan HuntLast Updated: $Id: config.html,v 1.3 2000/07/27 09:42:12 tale Exp $
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews</ADDRESS>
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User</BODY>
efb0e886f18894a1d2489f1ad74ad14b579e11c7Mark Andrews</HTML>
e813f036c8251b6d9d2a72fa84f80c2c9d2795afMark Andrews