contrib/bind/doc/html/config.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
   2 <HTML>
   3 <HEAD>
   4   <TITLE>BIND Configuration File Guide</TITLE>
   5 </HEAD>
   6
   7 <BODY>
   8 <H2>BIND Configuration File Guide</H2>
   9
  10 <HR>
  11
  12 <H3>Overview</H3>
  13
  14 <P>BIND 8 is much more configurable than previous release of BIND.
  15 There are entirely new areas of configuration, such as access control lists
  16 and categorized logging.  Many options that previously applied to all zones
  17 can now be used selectively.  These features, plus a consideration of future
  18 configuration needs led to the creation of a new configuration file format.
  19
  20 <H3>The Configuration File</H3>
  21
  22 <H4><A HREF="example.html">Example Configuration</A></H4>
  23
  24 <H4>Statements</H4>
  25
  26 <P>A BIND 8 configuration consists of statements and comments.
  27 Statements end with a semicolon.  Many statements contain a block of
  28 substatements, which are also terminated with a semicolon.</P>
  29
  30 <P>The following statements are supported:
  31 <DL>
  32 <DT><CODE><A HREF="acl.html">acl</A></CODE>
  33 <DD>
  34 defines a named IP address matching list, for access control and other uses
  35
  36 <DT><CODE><A HREF="include.html">include</A></CODE>
  37 <DD>
  38 includes a file
  39
  40 <DT><CODE><A HREF="key.html">key</A></CODE>
  41 <DD>
  42 specifies key information for use in authentication and authorization
  43
  44 <DT><CODE><A HREF="logging.html">logging</A></CODE>
  45 <DD>
  46 specifies what the server logs, and where the log messages are sent
  47
  48 <DT><CODE><A HREF="options.html">options</A></CODE>
  49 <DD>
  50 controls global server configuration options and sets defaults for other
  51 statements
  52
  53 <DT><CODE><A HREF="controls.html">controls</A></CODE>
  54 <DD>
  55 declares control channels to be used by the <VAR>ndc</VAR> utility
  56
  57 <DT><CODE><A HREF="server.html">server</A></CODE>
  58 <DD>
  59 sets certain configuration options on a per-server basis
  60
  61 <DT><CODE><A HREF="trusted-keys.html">trusted-keys</A></CODE>
  62 <DD>
  63 defines DNSSEC keys that are preconfigured into the server and implicitly
  64 trusted
  65
  66 <DT><CODE><A HREF="zone.html">zone</A></CODE>
  67 <DD>
  68 defines a zone
  69 </DL>
  70
  71 <P>The <CODE>logging</CODE> and <CODE>options</CODE> statements may only
  72 occur once per configuration.
  73
  74 <H4>Comments</H4>
  75
  76 The BIND 8 <A HREF="comments.html">comment syntax</A> allows for
  77 comments to appear anywhere that whitespace may appear in a BIND
  78 configuration file.  To appeal to programmers of all kinds, they can
  79 be written in C, C++, or shell/perl constructs.
  80
  81 <H3>Converting from BIND 4.9.x</H3>
  82
  83 <p>BIND 4.9.x configuration files can be converted to the new format by
  84 using <code>src/bin/named/named-bootconf</code>, a shell script that is part of
  85 the BIND 8.2.x source kits.
  86
  87 <HR>
  88
  89 <CENTER><P>[ <A HREF="http://www.isc.org/products/BIND/">BIND Home</A>
  90 |&nbsp;<A HREF="http://www.isc.org/">ISC</A> ]</P></CENTER>
  91
  92 <HR>
  93 <ADDRESS>
  94 Last Updated: $Id: config.html,v 1.10 1999/09/15 20:28:01 cyarnell Exp $
  95 </ADDRESS>
  96 </BODY>
  97 </HTML>