named.conf.docbook revision ec5347e2c775f027573ce5648b910361aa926c01
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg [<!ENTITY mdash "—">]>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg - Copyright (C) 2004-2007 Internet Systems Consortium, Inc. ("ISC")
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg - Permission to use, copy, modify, and/or distribute this software for any
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg - purpose with or without fee is hereby granted, provided that the above
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg - copyright notice and this permission notice appear in all copies.
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
0662ed52e814f8f08ef0e09956413a792584eddffuankg - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg - PERFORMANCE OF THIS SOFTWARE.
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg<!-- $Id: named.conf.docbook,v 1.30 2007/06/18 23:47:18 tbox Exp $ -->
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg <refentryinfo>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg </refentryinfo>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg <refentrytitle><filename>named.conf</filename></refentrytitle>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg <refnamediv>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg <refpurpose>configuration file for named</refpurpose>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg </refnamediv>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg <copyright>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg </copyright>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg <refsynopsisdiv>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg <cmdsynopsis>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg </cmdsynopsis>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg </refsynopsisdiv>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg <para><filename>named.conf</filename> is the configuration file
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg in braces and terminated with a semi-colon. Clauses in
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg the statements are also semi-colon terminated. The usual
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg comment styles are supported:
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg C style: /* */
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg C++ style: // to end of line
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg Unix style: # to end of line
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg </refsect1>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg <literallayout>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankgacl <replaceable>string</replaceable> { <replaceable>address_match_element</replaceable>; ... };
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg</literallayout>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg </refsect1>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg <literallayout>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg</literallayout>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg </refsect1>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg <literallayout>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankgmasters <replaceable>string</replaceable> <optional> port <replaceable>integer</replaceable> </optional> {
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg ( <replaceable>masters</replaceable> | <replaceable>ipv4_address</replaceable> <optional>port <replaceable>integer</replaceable></optional> |
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg <replaceable>ipv6_address</replaceable> <optional>port <replaceable>integer</replaceable></optional> ) <optional> key <replaceable>string</replaceable> </optional>; ...
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg</literallayout>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg </refsect1>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg <literallayout>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankgserver ( <replaceable>ipv4_address<optional>/prefixlen</optional></replaceable> | <replaceable>ipv6_address<optional>/prefixlen</optional></replaceable> ) {
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg transfer-format ( many-answers | one-answer );
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg transfer-source ( <replaceable>ipv4_address</replaceable> | * )
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg <optional> port ( <replaceable>integer</replaceable> | * ) </optional>;
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg transfer-source-v6 ( <replaceable>ipv6_address</replaceable> | * )
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg <optional> port ( <replaceable>integer</replaceable> | * ) </optional>;
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg support-ixfr <replaceable>boolean</replaceable>; // obsolete
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg</literallayout>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg </refsect1>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg <literallayout>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankgtrusted-keys {
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg <replaceable>domain_name</replaceable> <replaceable>flags</replaceable> <replaceable>protocol</replaceable> <replaceable>algorithm</replaceable> <replaceable>key</replaceable>; ...
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg</literallayout>
0662ed52e814f8f08ef0e09956413a792584eddffuankg </refsect1>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg <literallayout>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg inet ( <replaceable>ipv4_address</replaceable> | <replaceable>ipv6_address</replaceable> | * )
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg <optional> port ( <replaceable>integer</replaceable> | * ) </optional>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg allow { <replaceable>address_match_element</replaceable>; ... }
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg <optional> keys { <replaceable>string</replaceable>; ... } </optional>;
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg unix <replaceable>unsupported</replaceable>; // not implemented
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg</literallayout>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg </refsect1>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg <literallayout>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg category <replaceable>string</replaceable> { <replaceable>string</replaceable>; ... };
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg</literallayout>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg </refsect1>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg <literallayout>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg listen-on <optional> port <replaceable>integer</replaceable> </optional> {
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg ( <replaceable>ipv4_address</replaceable> | <replaceable>ipv6_address</replaceable> ) <optional> port <replaceable>integer</replaceable> </optional>; ...
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg view <replaceable>string</replaceable> <replaceable>optional_class</replaceable>;
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg</literallayout>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg </refsect1>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg <literallayout>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg avoid-v4-udp-ports { <replaceable>port</replaceable>; ... };
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg avoid-v6-udp-ports { <replaceable>port</replaceable>; ... };
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg blackhole { <replaceable>address_match_element</replaceable>; ... };
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg heartbeat-interval <replaceable>integer</replaceable>;
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg host-statistics <replaceable>boolean</replaceable>; // not implemented
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg host-statistics-max <replaceable>number</replaceable>; // not implemented
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg hostname ( <replaceable>quoted_string</replaceable> | none );
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg interface-interval <replaceable>integer</replaceable>;
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg listen-on <optional> port <replaceable>integer</replaceable> </optional> { <replaceable>address_match_element</replaceable>; ... };
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg listen-on-v6 <optional> port <replaceable>integer</replaceable> </optional> { <replaceable>address_match_element</replaceable>; ... };
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg match-mapped-addresses <replaceable>boolean</replaceable>;
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg memstatistics-file <replaceable>quoted_string</replaceable>;
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg pid-file ( <replaceable>quoted_string</replaceable> | none );
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg recursing-file <replaceable>quoted_string</replaceable>;
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg random-device <replaceable>quoted_string</replaceable>;
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg recursive-clients <replaceable>integer</replaceable>;
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg serial-query-rate <replaceable>integer</replaceable>;
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg server-id ( <replaceable>quoted_string</replaceable> | none |;
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg statistics-file <replaceable>quoted_string</replaceable>;
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg statistics-interval <replaceable>integer</replaceable>; // not yet implemented
8ffac2c334103c0336602aaede650cb578611151fuankg tkey-dhkey <replaceable>quoted_string</replaceable> <replaceable>integer</replaceable>;
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg tkey-gssapi-credential <replaceable>quoted_string</replaceable>;
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg tkey-domain <replaceable>quoted_string</replaceable>;
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg version ( <replaceable>quoted_string</replaceable> | none );
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg allow-recursion { <replaceable>address_match_element</replaceable>; ... };
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg allow-recursion-on { <replaceable>address_match_element</replaceable>; ... };
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg sortlist { <replaceable>address_match_element</replaceable>; ... };
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg topology { <replaceable>address_match_element</replaceable>; ... }; // not implemented
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg auth-nxdomain <replaceable>boolean</replaceable>; // default changed
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg minimal-responses <replaceable>boolean</replaceable>;
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg rrset-order {
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg <optional> class <replaceable>string</replaceable> </optional> <optional> type <replaceable>string</replaceable> </optional>
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg <optional> name <replaceable>quoted_string</replaceable> </optional> <replaceable>string</replaceable> <replaceable>string</replaceable>; ...
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg rfc2308-type1 <replaceable>boolean</replaceable>; // not yet implemented
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg additional-from-auth <replaceable>boolean</replaceable>;
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg additional-from-cache <replaceable>boolean</replaceable>;
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg query-source ( ( <replaceable>ipv4_address</replaceable> | * ) | <optional> address ( <replaceable>ipv4_address</replaceable> | * ) </optional> ) <optional> port ( <replaceable>integer</replaceable> | * ) </optional>;
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg query-source-v6 ( ( <replaceable>ipv6_address</replaceable> | * ) | <optional> address ( <replaceable>ipv6_address</replaceable> | * ) </optional> ) <optional> port ( <replaceable>integer</replaceable> | * ) </optional>;
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg use-queryport-pool <replaceable>boolean</replaceable>;
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg queryport-pool-ports <replaceable>integer</replaceable>;
0662ed52e814f8f08ef0e09956413a792584eddffuankg queryport-pool-updateinterval <replaceable>integer</replaceable>;
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg cleaning-interval <replaceable>integer</replaceable>;
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg min-roots <replaceable>integer</replaceable>; // not implemented
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg transfer-format ( many-answers | one-answer );
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg max-cache-size <replaceable>size_no_default</replaceable>;
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg max-acache-size <replaceable>size_no_default</replaceable>;
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg max-clients-per-query <replaceable>number</replaceable>;
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg check-names ( master | slave | response )
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg ( fail | warn | ignore );
0662ed52e814f8f08ef0e09956413a792584eddffuankg check-mx ( fail | warn | ignore );
ff7e89a077d93c243bd8261cf3c72b13732ab5b4fuankg check-mx-cname ( fail | warn | ignore );
( <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>; ...