named.conf.docbook revision c1a883f2e04d94e99c433b1f6cfd0c0338f4ed85
7fd0120946822608dcfd6967ce427df472768ed4miklosh<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
7fd0120946822608dcfd6967ce427df472768ed4miklosh "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
7fd0120946822608dcfd6967ce427df472768ed4miklosh [<!ENTITY mdash "—">]>
7fd0120946822608dcfd6967ce427df472768ed4miklosh - Copyright (C) 2004-2007 Internet Systems Consortium, Inc. ("ISC")
7fd0120946822608dcfd6967ce427df472768ed4miklosh - Permission to use, copy, modify, and distribute this software for any
7fd0120946822608dcfd6967ce427df472768ed4miklosh - purpose with or without fee is hereby granted, provided that the above
e4b626a9206e4fabf4fc7601dfa14b133c2a27f0Krzysztof Kosiński - copyright notice and this permission notice appear in all copies.
7fd0120946822608dcfd6967ce427df472768ed4miklosh - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
4b1c2be41ce8c1a88502c1b1885ad1468646fbfftheadib - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
7fd0120946822608dcfd6967ce427df472768ed4miklosh - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
7fd0120946822608dcfd6967ce427df472768ed4miklosh - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
7fd0120946822608dcfd6967ce427df472768ed4miklosh - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
7fd0120946822608dcfd6967ce427df472768ed4miklosh - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
7fd0120946822608dcfd6967ce427df472768ed4miklosh - PERFORMANCE OF THIS SOFTWARE.
7fd0120946822608dcfd6967ce427df472768ed4miklosh<!-- $Id: named.conf.docbook,v 1.26 2007/01/29 23:57:22 marka Exp $ -->
7fd0120946822608dcfd6967ce427df472768ed4miklosh <refentryinfo>
25479c033c7ed6bc12fc4d1e94f7385b02e9304djohanengelen </refentryinfo>
7fd0120946822608dcfd6967ce427df472768ed4miklosh <refentrytitle><filename>named.conf</filename></refentrytitle>
31ccc3d52e54ddb1330b3e7252d8a3ef488a390dMarkus Engel <refnamediv>
44ed6dfe15487cdc5a4c78b7d07fcfcd0164bc42Liam P. White <refpurpose>configuration file for named</refpurpose>
44ed6dfe15487cdc5a4c78b7d07fcfcd0164bc42Liam P. White </refnamediv>
7fd0120946822608dcfd6967ce427df472768ed4miklosh <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
7fd0120946822608dcfd6967ce427df472768ed4miklosh </copyright>
7fd0120946822608dcfd6967ce427df472768ed4miklosh <refsynopsisdiv>
7fd0120946822608dcfd6967ce427df472768ed4miklosh <cmdsynopsis>
7fd0120946822608dcfd6967ce427df472768ed4miklosh </cmdsynopsis>
7fd0120946822608dcfd6967ce427df472768ed4miklosh </refsynopsisdiv>
7fd0120946822608dcfd6967ce427df472768ed4miklosh <para><filename>named.conf</filename> is the configuration file
7fd0120946822608dcfd6967ce427df472768ed4miklosh in braces and terminated with a semi-colon. Clauses in
7fd0120946822608dcfd6967ce427df472768ed4miklosh the statements are also semi-colon terminated. The usual
7fd0120946822608dcfd6967ce427df472768ed4miklosh comment styles are supported:
7fd0120946822608dcfd6967ce427df472768ed4miklosh C style: /* */
7fd0120946822608dcfd6967ce427df472768ed4miklosh C++ style: // to end of line
7fd0120946822608dcfd6967ce427df472768ed4miklosh Unix style: # to end of line
7fd0120946822608dcfd6967ce427df472768ed4miklosh </refsect1>
7fd0120946822608dcfd6967ce427df472768ed4miklosh <literallayout>
7fd0120946822608dcfd6967ce427df472768ed4mikloshacl <replaceable>string</replaceable> { <replaceable>address_match_element</replaceable>; ... };
7fd0120946822608dcfd6967ce427df472768ed4miklosh</literallayout>
7fd0120946822608dcfd6967ce427df472768ed4miklosh </refsect1>
7fd0120946822608dcfd6967ce427df472768ed4miklosh <literallayout>
7fd0120946822608dcfd6967ce427df472768ed4miklosh</literallayout>
4b1c2be41ce8c1a88502c1b1885ad1468646fbfftheadib </refsect1>
f8126a79cb9116058bdaaa62ee7fd203234ff897keescook <literallayout>
cfdfe409e3f0e89429aa413061053432385ec994theadibmasters <replaceable>string</replaceable> <optional> port <replaceable>integer</replaceable> </optional> {
7fd0120946822608dcfd6967ce427df472768ed4miklosh ( <replaceable>masters</replaceable> | <replaceable>ipv4_address</replaceable> <optional>port <replaceable>integer</replaceable></optional> |
4b1c2be41ce8c1a88502c1b1885ad1468646fbfftheadib <replaceable>ipv6_address</replaceable> <optional>port <replaceable>integer</replaceable></optional> ) <optional> key <replaceable>string</replaceable> </optional>; ...
861fa436e7a6d6ff3eaa889b2298e0b82a0b238ctheadib</literallayout>
4b1c2be41ce8c1a88502c1b1885ad1468646fbfftheadib </refsect1>
31b8809550c17f5de51b6ccd3dd61be334ffc7f8David R. Bild <literallayout>
4b1c2be41ce8c1a88502c1b1885ad1468646fbfftheadibserver ( <replaceable>ipv4_address<optional>/prefixlen</optional></replaceable> | <replaceable>ipv6_address<optional>/prefixlen</optional></replaceable> ) {
7fd0120946822608dcfd6967ce427df472768ed4miklosh transfer-format ( many-answers | one-answer );
7fd0120946822608dcfd6967ce427df472768ed4miklosh transfer-source ( <replaceable>ipv4_address</replaceable> | * )
7fd0120946822608dcfd6967ce427df472768ed4miklosh <optional> port ( <replaceable>integer</replaceable> | * ) </optional>;
7fd0120946822608dcfd6967ce427df472768ed4miklosh transfer-source-v6 ( <replaceable>ipv6_address</replaceable> | * )
7fd0120946822608dcfd6967ce427df472768ed4miklosh <optional> port ( <replaceable>integer</replaceable> | * ) </optional>;
31b8809550c17f5de51b6ccd3dd61be334ffc7f8David R. Bild support-ixfr <replaceable>boolean</replaceable>; // obsolete
31b8809550c17f5de51b6ccd3dd61be334ffc7f8David R. Bild</literallayout>
7fd0120946822608dcfd6967ce427df472768ed4miklosh </refsect1>
7fd0120946822608dcfd6967ce427df472768ed4miklosh <literallayout>
4b1c2be41ce8c1a88502c1b1885ad1468646fbfftheadibtrusted-keys {
b5ea3ee18029be0e1660324cb5df658ec6dc99d3johanengelen <replaceable>domain_name</replaceable> <replaceable>flags</replaceable> <replaceable>protocol</replaceable> <replaceable>algorithm</replaceable> <replaceable>key</replaceable>; ...
4b1c2be41ce8c1a88502c1b1885ad1468646fbfftheadib</literallayout>
7fd0120946822608dcfd6967ce427df472768ed4miklosh </refsect1>
7fd0120946822608dcfd6967ce427df472768ed4miklosh <literallayout>
7fd0120946822608dcfd6967ce427df472768ed4miklosh inet ( <replaceable>ipv4_address</replaceable> | <replaceable>ipv6_address</replaceable> | * )
7fd0120946822608dcfd6967ce427df472768ed4miklosh <optional> port ( <replaceable>integer</replaceable> | * ) </optional>
7fd0120946822608dcfd6967ce427df472768ed4miklosh allow { <replaceable>address_match_element</replaceable>; ... }
7fd0120946822608dcfd6967ce427df472768ed4miklosh <optional> keys { <replaceable>string</replaceable>; ... } </optional>;
36bb2154f1627a17c3591eb4d7f89335e8b5daddKrzysztof Kosinski unix <replaceable>unsupported</replaceable>; // not implemented
36bb2154f1627a17c3591eb4d7f89335e8b5daddKrzysztof Kosinski</literallayout>
7fd0120946822608dcfd6967ce427df472768ed4miklosh <literallayout>
36bb2154f1627a17c3591eb4d7f89335e8b5daddKrzysztof Kosinski file <replaceable>log_file</replaceable>;
e4b626a9206e4fabf4fc7601dfa14b133c2a27f0Krzysztof Kosiński syslog <replaceable>optional_facility</replaceable>;
7fd0120946822608dcfd6967ce427df472768ed4miklosh category <replaceable>string</replaceable> { <replaceable>string</replaceable>; ... };
4b1c2be41ce8c1a88502c1b1885ad1468646fbfftheadib</literallayout>
53ed40aaa67af4cc653f35323ca466a7c75436e4David R. Bild <literallayout>
7fd0120946822608dcfd6967ce427df472768ed4miklosh listen-on <optional> port <replaceable>integer</replaceable> </optional> {
7fd0120946822608dcfd6967ce427df472768ed4miklosh ( <replaceable>ipv4_address</replaceable> | <replaceable>ipv6_address</replaceable> ) <optional> port <replaceable>integer</replaceable> </optional>; ...
4b1c2be41ce8c1a88502c1b1885ad1468646fbfftheadib view <replaceable>string</replaceable> <replaceable>optional_class</replaceable>;
31b8809550c17f5de51b6ccd3dd61be334ffc7f8David R. Bild</literallayout>
4b1c2be41ce8c1a88502c1b1885ad1468646fbfftheadib </refsect1>
4b1c2be41ce8c1a88502c1b1885ad1468646fbfftheadib <literallayout>
7fd0120946822608dcfd6967ce427df472768ed4miklosh avoid-v4-udp-ports { <replaceable>port</replaceable>; ... };
7fd0120946822608dcfd6967ce427df472768ed4miklosh avoid-v6-udp-ports { <replaceable>port</replaceable>; ... };
90a3966dd44e306d23febc15ebd65cde07d7a4ddTed Gould blackhole { <replaceable>address_match_element</replaceable>; ... };
7fd0120946822608dcfd6967ce427df472768ed4miklosh heartbeat-interval <replaceable>integer</replaceable>;
7fd0120946822608dcfd6967ce427df472768ed4miklosh host-statistics <replaceable>boolean</replaceable>; // not implemented
4b1c2be41ce8c1a88502c1b1885ad1468646fbfftheadib host-statistics-max <replaceable>number</replaceable>; // not implemented
7fd0120946822608dcfd6967ce427df472768ed4miklosh hostname ( <replaceable>quoted_string</replaceable> | none );
7fd0120946822608dcfd6967ce427df472768ed4miklosh interface-interval <replaceable>integer</replaceable>;
4b1c2be41ce8c1a88502c1b1885ad1468646fbfftheadib listen-on <optional> port <replaceable>integer</replaceable> </optional> { <replaceable>address_match_element</replaceable>; ... };
7fd0120946822608dcfd6967ce427df472768ed4miklosh listen-on-v6 <optional> port <replaceable>integer</replaceable> </optional> { <replaceable>address_match_element</replaceable>; ... };
7fd0120946822608dcfd6967ce427df472768ed4miklosh match-mapped-addresses <replaceable>boolean</replaceable>;
7fd0120946822608dcfd6967ce427df472768ed4miklosh memstatistics-file <replaceable>quoted_string</replaceable>;
7fd0120946822608dcfd6967ce427df472768ed4miklosh pid-file ( <replaceable>quoted_string</replaceable> | none );
53ed40aaa67af4cc653f35323ca466a7c75436e4David R. Bild recursing-file <replaceable>quoted_string</replaceable>;
7fd0120946822608dcfd6967ce427df472768ed4miklosh random-device <replaceable>quoted_string</replaceable>;
36bb2154f1627a17c3591eb4d7f89335e8b5daddKrzysztof Kosinski recursive-clients <replaceable>integer</replaceable>;
36bb2154f1627a17c3591eb4d7f89335e8b5daddKrzysztof Kosinski serial-query-rate <replaceable>integer</replaceable>;
4b1c2be41ce8c1a88502c1b1885ad1468646fbfftheadib server-id ( <replaceable>quoted_string</replaceable> | none |;
7fd0120946822608dcfd6967ce427df472768ed4miklosh statistics-file <replaceable>quoted_string</replaceable>;
cfdfe409e3f0e89429aa413061053432385ec994theadib statistics-interval <replaceable>integer</replaceable>; // not yet implemented
36bb2154f1627a17c3591eb4d7f89335e8b5daddKrzysztof Kosinski tcp-clients <replaceable>integer</replaceable>;
36bb2154f1627a17c3591eb4d7f89335e8b5daddKrzysztof Kosinski tcp-listen-queue <replaceable>integer</replaceable>;
4b1c2be41ce8c1a88502c1b1885ad1468646fbfftheadib tkey-dhkey <replaceable>quoted_string</replaceable> <replaceable>integer</replaceable>;
36bb2154f1627a17c3591eb4d7f89335e8b5daddKrzysztof Kosinski tkey-gssapi-credential <replaceable>quoted_string</replaceable>;
7fd0120946822608dcfd6967ce427df472768ed4miklosh tkey-domain <replaceable>quoted_string</replaceable>;
36bb2154f1627a17c3591eb4d7f89335e8b5daddKrzysztof Kosinski transfers-per-ns <replaceable>integer</replaceable>;
53ed40aaa67af4cc653f35323ca466a7c75436e4David R. Bild transfers-out <replaceable>integer</replaceable>;
53ed40aaa67af4cc653f35323ca466a7c75436e4David R. Bild version ( <replaceable>quoted_string</replaceable> | none );
0974913b991ec9600541134006189f7851352d68scislac allow-recursion { <replaceable>address_match_element</replaceable>; ... };
0974913b991ec9600541134006189f7851352d68scislac sortlist { <replaceable>address_match_element</replaceable>; ... };
0974913b991ec9600541134006189f7851352d68scislac topology { <replaceable>address_match_element</replaceable>; ... }; // not implemented
7fd0120946822608dcfd6967ce427df472768ed4miklosh auth-nxdomain <replaceable>boolean</replaceable>; // default changed
7fd0120946822608dcfd6967ce427df472768ed4miklosh minimal-responses <replaceable>boolean</replaceable>;
7fd0120946822608dcfd6967ce427df472768ed4miklosh rrset-order {
7fd0120946822608dcfd6967ce427df472768ed4miklosh <optional> class <replaceable>string</replaceable> </optional> <optional> type <replaceable>string</replaceable> </optional>
7fd0120946822608dcfd6967ce427df472768ed4miklosh <optional> name <replaceable>quoted_string</replaceable> </optional> <replaceable>string</replaceable> <replaceable>string</replaceable>; ...
7fd0120946822608dcfd6967ce427df472768ed4miklosh rfc2308-type1 <replaceable>boolean</replaceable>; // not yet implemented
7fd0120946822608dcfd6967ce427df472768ed4miklosh additional-from-auth <replaceable>boolean</replaceable>;
7fd0120946822608dcfd6967ce427df472768ed4miklosh additional-from-cache <replaceable>boolean</replaceable>;
7fd0120946822608dcfd6967ce427df472768ed4miklosh query-source ( ( <replaceable>ipv4_address</replaceable> | * ) | <optional> address ( <replaceable>ipv4_address</replaceable> | * ) </optional> ) <optional> port ( <replaceable>integer</replaceable> | * ) </optional>;
7fd0120946822608dcfd6967ce427df472768ed4miklosh query-source-v6 ( ( <replaceable>ipv6_address</replaceable> | * ) | <optional> address ( <replaceable>ipv6_address</replaceable> | * ) </optional> ) <optional> port ( <replaceable>integer</replaceable> | * ) </optional>;
7fd0120946822608dcfd6967ce427df472768ed4miklosh cleaning-interval <replaceable>integer</replaceable>;
7fd0120946822608dcfd6967ce427df472768ed4miklosh min-roots <replaceable>integer</replaceable>; // not implemented
a4030d5ca449e7e384bc699cd249ee704faaeab0Chris Morgan max-cache-ttl <replaceable>integer</replaceable>;
( <replaceable>quoted_string</replaceable> <optional>port <replaceable>integer</replaceable></optional> |
<replaceable>ipv4_address</replaceable> <optional>port <replaceable>integer</replaceable></optional> |
<replaceable>ipv6_address</replaceable> <optional>port <replaceable>integer</replaceable></optional> ); ...
root-delegation-only <optional> exclude { <replaceable>quoted_string</replaceable>; ... } </optional>;
notify-source ( <replaceable>ipv4_address</replaceable> | * ) <optional> port ( <replaceable>integer</replaceable> | * ) </optional>;
notify-source-v6 ( <replaceable>ipv6_address</replaceable> | * ) <optional> port ( <replaceable>integer</replaceable> | * ) </optional>;
also-notify <optional> port <replaceable>integer</replaceable> </optional> { ( <replaceable>ipv4_address</replaceable> | <replaceable>ipv6_address</replaceable> )
( <replaceable>ipv4_address</replaceable> | <replaceable>ipv6_address</replaceable> ) <optional> port <replaceable>integer</replaceable> </optional>; ...
server ( <replaceable>ipv4_address<optional>/prefixlen</optional></replaceable> | <replaceable>ipv6_address<optional>/prefixlen</optional></replaceable> ) {
<replaceable>string</replaceable> <replaceable>integer</replaceable> <replaceable>integer</replaceable> <replaceable>integer</replaceable> <replaceable>quoted_string</replaceable>; ...
<optional> class <replaceable>string</replaceable> </optional> <optional> type <replaceable>string</replaceable> </optional>
<optional> name <replaceable>quoted_string</replaceable> </optional> <replaceable>string</replaceable> <replaceable>string</replaceable>; ...
query-source ( ( <replaceable>ipv4_address</replaceable> | * ) | <optional> address ( <replaceable>ipv4_address</replaceable> | * ) </optional> ) <optional> port ( <replaceable>integer</replaceable> | * ) </optional>;
query-source-v6 ( ( <replaceable>ipv6_address</replaceable> | * ) | <optional> address ( <replaceable>ipv6_address</replaceable> | * ) </optional> ) <optional> port ( <replaceable>integer</replaceable> | * ) </optional>;
( <replaceable>quoted_string</replaceable> <optional>port <replaceable>integer</replaceable></optional> |
<replaceable>ipv4_address</replaceable> <optional>port <replaceable>integer</replaceable></optional> |
<replaceable>ipv6_address</replaceable> <optional>port <replaceable>integer</replaceable></optional> ); ...
root-delegation-only <optional> exclude { <replaceable>quoted_string</replaceable>; ... } </optional>;
notify-source ( <replaceable>ipv4_address</replaceable> | * ) <optional> port ( <replaceable>integer</replaceable> | * ) </optional>;
notify-source-v6 ( <replaceable>ipv6_address</replaceable> | * ) <optional> port ( <replaceable>integer</replaceable> | * ) </optional>;
also-notify <optional> port <replaceable>integer</replaceable> </optional> { ( <replaceable>ipv4_address</replaceable> | <replaceable>ipv6_address</replaceable> )
( <replaceable>ipv4_address</replaceable> | <replaceable>ipv6_address</replaceable> ) <optional> port <replaceable>integer</replaceable> </optional>; ...
<replaceable>ipv4_address</replaceable> <optional>port <replaceable>integer</replaceable></optional> |
<replaceable>ipv6_address</replaceable> <optional> port <replaceable>integer</replaceable> </optional> ) <optional> key <replaceable>string</replaceable> </optional>; ...
notify-source ( <replaceable>ipv4_address</replaceable> | * ) <optional> port ( <replaceable>integer</replaceable> | * ) </optional>;
notify-source-v6 ( <replaceable>ipv6_address</replaceable> | * ) <optional> port ( <replaceable>integer</replaceable> | * ) </optional>;
also-notify <optional> port <replaceable>integer</replaceable> </optional> { ( <replaceable>ipv4_address</replaceable> | <replaceable>ipv6_address</replaceable> )
( <replaceable>ipv4_address</replaceable> | <replaceable>ipv6_address</replaceable> ) <optional> port <replaceable>integer</replaceable> </optional>; ...