named.conf.docbook revision cfe92110ce4eaf19f7f3255d2961710879bdc9dd
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.0//EN"
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff "http://www.oasis-open.org/docbook/xml/4.0/docbookx.dtd"
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff [<!ENTITY mdash "—">]>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff - Copyright (C) 2004-2006 Internet Systems Consortium, Inc. ("ISC")
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff - Permission to use, copy, modify, and distribute this software for any
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff - purpose with or without fee is hereby granted, provided that the above
8cf870d281dc8c242f083d14dfef05f24aa5fceeJnRouvignac - copyright notice and this permission notice appear in all copies.
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
8cf870d281dc8c242f083d14dfef05f24aa5fceeJnRouvignac - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
8cf870d281dc8c242f083d14dfef05f24aa5fceeJnRouvignac - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
8cf870d281dc8c242f083d14dfef05f24aa5fceeJnRouvignac - PERFORMANCE OF THIS SOFTWARE.
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff<!-- $Id: named.conf.docbook,v 1.21 2006/03/09 23:21:53 marka Exp $ -->
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff <refentryinfo>
06332cdbe10aaf7af368090091f6f0aeffdeac85jvergara </refentryinfo>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff <refentrytitle><filename>named.conf</filename></refentrytitle>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff <refnamediv>
06332cdbe10aaf7af368090091f6f0aeffdeac85jvergara <refpurpose>configuration file for named</refpurpose>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff </refnamediv>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff <copyright>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff </copyright>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff <refsynopsisdiv>
06332cdbe10aaf7af368090091f6f0aeffdeac85jvergara <cmdsynopsis>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff </cmdsynopsis>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff </refsynopsisdiv>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff <para><filename>named.conf</filename> is the configuration file
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff in braces and terminated with a semi-colon. Clauses in
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff the statements are also semi-colon terminated. The usual
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff comment styles are supported:
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff C style: /* */
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff C++ style: // to end of line
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff Unix style: # to end of line
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff </refsect1>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff <literallayout>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduffacl <replaceable>string</replaceable> { <replaceable>address_match_element</replaceable>; ... };
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff</literallayout>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff </refsect1>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff <literallayout>
9b09e08b4d4f555d0d0d294df4c8dc601754ad92JnRouvignac</literallayout>
9b09e08b4d4f555d0d0d294df4c8dc601754ad92JnRouvignac <literallayout>
9b09e08b4d4f555d0d0d294df4c8dc601754ad92JnRouvignacmasters <replaceable>string</replaceable> <optional> port <replaceable>integer</replaceable> </optional> {
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff ( <replaceable>masters</replaceable> | <replaceable>ipv4_address</replaceable> <optional>port <replaceable>integer</replaceable></optional> |
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff <replaceable>ipv6_address</replaceable> <optional>port <replaceable>integer</replaceable></optional> ) <optional> key <replaceable>string</replaceable> </optional>; ...
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff</literallayout>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff </refsect1>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff <literallayout>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduffserver ( <replaceable>ipv4_address<optional>/prefixlen</optional></replaceable> | <replaceable>ipv6_address<optional>/prefixlen</optional></replaceable> ) {
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff transfer-format ( many-answers | one-answer );
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff transfer-source ( <replaceable>ipv4_address</replaceable> | * )
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff <optional> port ( <replaceable>integer</replaceable> | * ) </optional>;
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff transfer-source-v6 ( <replaceable>ipv6_address</replaceable> | * )
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff <optional> port ( <replaceable>integer</replaceable> | * ) </optional>;
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff support-ixfr <replaceable>boolean</replaceable>; // obsolete
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff</literallayout>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff </refsect1>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff <literallayout>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcdufftrusted-keys {
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff <replaceable>domain_name</replaceable> <replaceable>flags</replaceable> <replaceable>protocol</replaceable> <replaceable>algorithm</replaceable> <replaceable>key</replaceable>; ...
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff</literallayout>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff </refsect1>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff <literallayout>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff inet ( <replaceable>ipv4_address</replaceable> | <replaceable>ipv6_address</replaceable> | * )
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff <optional> port ( <replaceable>integer</replaceable> | * ) </optional>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff allow { <replaceable>address_match_element</replaceable>; ... }
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff <optional> keys { <replaceable>string</replaceable>; ... } </optional>;
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff unix <replaceable>unsupported</replaceable>; // not implemented
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff</literallayout>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff </refsect1>
ad9d86a5c3b3d0a2373882a4ef34efb984b53ceajvergara <literallayout>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff category <replaceable>string</replaceable> { <replaceable>string</replaceable>; ... };
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff</literallayout>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff </refsect1>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff <literallayout>
06332cdbe10aaf7af368090091f6f0aeffdeac85jvergara listen-on <optional> port <replaceable>integer</replaceable> </optional> {
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff ( <replaceable>ipv4_address</replaceable> | <replaceable>ipv6_address</replaceable> ) <optional> port <replaceable>integer</replaceable> </optional>; ...
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff view <replaceable>string</replaceable> <replaceable>optional_class</replaceable>;
06332cdbe10aaf7af368090091f6f0aeffdeac85jvergara</literallayout>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff </refsect1>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff <literallayout>
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff avoid-v4-udp-ports { <replaceable>port</replaceable>; ... };
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff avoid-v6-udp-ports { <replaceable>port</replaceable>; ... };
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff blackhole { <replaceable>address_match_element</replaceable>; ... };
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff heartbeat-interval <replaceable>integer</replaceable>;
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff host-statistics <replaceable>boolean</replaceable>; // not implemented
62104ed5c93ba48512e847313db5ec552f68ab0cjvergara host-statistics-max <replaceable>number</replaceable>; // not implemented
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff hostname ( <replaceable>quoted_string</replaceable> | none );
ad9d86a5c3b3d0a2373882a4ef34efb984b53ceajvergara interface-interval <replaceable>integer</replaceable>;
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff listen-on <optional> port <replaceable>integer</replaceable> </optional> { <replaceable>address_match_element</replaceable>; ... };
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff listen-on-v6 <optional> port <replaceable>integer</replaceable> </optional> { <replaceable>address_match_element</replaceable>; ... };
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff match-mapped-addresses <replaceable>boolean</replaceable>;
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff memstatistics-file <replaceable>quoted_string</replaceable>;
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff pid-file ( <replaceable>quoted_string</replaceable> | none );
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff recursing-file <replaceable>quoted_string</replaceable>;
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff random-device <replaceable>quoted_string</replaceable>;
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff recursive-clients <replaceable>integer</replaceable>;
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff serial-query-rate <replaceable>integer</replaceable>;
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff server-id ( <replaceable>quoted_string</replaceable> | none |;
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff statistics-file <replaceable>quoted_string</replaceable>;
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff statistics-interval <replaceable>integer</replaceable>; // not yet implemented
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff tkey-dhkey <replaceable>quoted_string</replaceable> <replaceable>integer</replaceable>;
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff tkey-gssapi-credential <replaceable>quoted_string</replaceable>;
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff tkey-domain <replaceable>quoted_string</replaceable>;
06332cdbe10aaf7af368090091f6f0aeffdeac85jvergara transfers-per-ns <replaceable>integer</replaceable>;
06332cdbe10aaf7af368090091f6f0aeffdeac85jvergara version ( <replaceable>quoted_string</replaceable> | none );
06332cdbe10aaf7af368090091f6f0aeffdeac85jvergara allow-recursion { <replaceable>address_match_element</replaceable>; ... };
06332cdbe10aaf7af368090091f6f0aeffdeac85jvergara sortlist { <replaceable>address_match_element</replaceable>; ... };
06332cdbe10aaf7af368090091f6f0aeffdeac85jvergara topology { <replaceable>address_match_element</replaceable>; ... }; // not implemented
06332cdbe10aaf7af368090091f6f0aeffdeac85jvergara auth-nxdomain <replaceable>boolean</replaceable>; // default changed
06332cdbe10aaf7af368090091f6f0aeffdeac85jvergara minimal-responses <replaceable>boolean</replaceable>;
06332cdbe10aaf7af368090091f6f0aeffdeac85jvergara rrset-order {
06332cdbe10aaf7af368090091f6f0aeffdeac85jvergara <optional> class <replaceable>string</replaceable> </optional> <optional> type <replaceable>string</replaceable> </optional>
06332cdbe10aaf7af368090091f6f0aeffdeac85jvergara <optional> name <replaceable>quoted_string</replaceable> </optional> <replaceable>string</replaceable> <replaceable>string</replaceable>; ...
06332cdbe10aaf7af368090091f6f0aeffdeac85jvergara rfc2308-type1 <replaceable>boolean</replaceable>; // not yet implemented
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff additional-from-auth <replaceable>boolean</replaceable>;
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff additional-from-cache <replaceable>boolean</replaceable>;
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff query-source <replaceable>querysource4</replaceable>;
9b09e08b4d4f555d0d0d294df4c8dc601754ad92JnRouvignac query-source-v6 <replaceable>querysource6</replaceable>;
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff cleaning-interval <replaceable>integer</replaceable>;
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff min-roots <replaceable>integer</replaceable>; // not implemented
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff transfer-format ( many-answers | one-answer );
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff max-cache-size <replaceable>size_no_default</replaceable>;
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff max-acache-size <replaceable>size_no_default</replaceable>;
9b09e08b4d4f555d0d0d294df4c8dc601754ad92JnRouvignac clients-per-query <replaceable>number</replaceable>;
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff max-clients-per-query <replaceable>number</replaceable>;
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff check-names ( master | slave | response )
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff ( fail | warn | ignore );
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff check-mx ( fail | warn | ignore );
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff check-mx-cname ( fail | warn | ignore );
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff check-srv-cname ( fail | warn | ignore );
9b09e08b4d4f555d0d0d294df4c8dc601754ad92JnRouvignac suppress-initial-notify <replaceable>boolean</replaceable>; // not yet implemented
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff dual-stack-servers <optional> port <replaceable>integer</replaceable> </optional> {
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff ( <replaceable>quoted_string</replaceable> <optional>port <replaceable>integer</replaceable></optional> |
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff <replaceable>ipv4_address</replaceable> <optional>port <replaceable>integer</replaceable></optional> |
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff <replaceable>ipv6_address</replaceable> <optional>port <replaceable>integer</replaceable></optional> ); ...
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff root-delegation-only <optional> exclude { <replaceable>quoted_string</replaceable>; ... } </optional>;
ad9d86a5c3b3d0a2373882a4ef34efb984b53ceajvergara disable-algorithms <replaceable>string</replaceable> { <replaceable>string</replaceable>; ... };
06332cdbe10aaf7af368090091f6f0aeffdeac85jvergara dnssec-validation <replaceable>boolean</replaceable>;
06332cdbe10aaf7af368090091f6f0aeffdeac85jvergara dnssec-lookaside <replaceable>string</replaceable> trust-anchor <replaceable>string</replaceable>;
06332cdbe10aaf7af368090091f6f0aeffdeac85jvergara dnssec-must-be-secure <replaceable>string</replaceable> <replaceable>boolean</replaceable>;
06332cdbe10aaf7af368090091f6f0aeffdeac85jvergara dnssec-accept-expired <replaceable>boolean</replaceable>;
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff empty-zones-enable <replaceable>boolean</replaceable>;
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff disable-empty-zone <replaceable>string</replaceable>;
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff ixfr-from-differences <replaceable>ixfrdiff</replaceable>;
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff allow-query { <replaceable>address_match_element</replaceable>; ... };
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff allow-query-cache { <replaceable>address_match_element</replaceable>; ... };
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff allow-transfer { <replaceable>address_match_element</replaceable>; ... };
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff allow-update { <replaceable>address_match_element</replaceable>; ... };
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff allow-update-forwarding { <replaceable>address_match_element</replaceable>; ... };
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff notify-source ( <replaceable>ipv4_address</replaceable> | * ) <optional> port ( <replaceable>integer</replaceable> | * ) </optional>;
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff notify-source-v6 ( <replaceable>ipv6_address</replaceable> | * ) <optional> port ( <replaceable>integer</replaceable> | * ) </optional>;
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff also-notify <optional> port <replaceable>integer</replaceable> </optional> { ( <replaceable>ipv4_address</replaceable> | <replaceable>ipv6_address</replaceable> )
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff <optional> port <replaceable>integer</replaceable> </optional>; ... };
d25372dc8e65a9ed019a88fdf659ca61313f1b31jcduff allow-notify { <replaceable>address_match_element</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>; ...
( <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>; ...