named.conf.docbook revision ecc06cbc32c5a2b91a17e65c1820c9c66313d35c
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran - Copyright (C) 2004-2015 Internet Systems Consortium, Inc. ("ISC")
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran - Permission to use, copy, modify, and/or distribute this software for any
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran - purpose with or without fee is hereby granted, provided that the above
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran - copyright notice and this permission notice appear in all copies.
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran - PERFORMANCE OF THIS SOFTWARE.
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran<!-- Converted by db4-upgrade version 1.0 -->
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="man.named.conf">
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran <refentryinfo>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran <corpauthor>Internet Systems Consortium, Inc.</corpauthor>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran </refentryinfo>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran <refentrytitle><filename>named.conf</filename></refentrytitle>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran <refname><filename>named.conf</filename></refname>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran <refpurpose>configuration file for <command>named</command></refpurpose>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran </refnamediv>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran <refsynopsisdiv>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran </cmdsynopsis>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran </refsynopsisdiv>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran <refsection><info><title>DESCRIPTION</title></info>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran <para><filename>named.conf</filename> is the configuration file
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran <command>named</command>. Statements are enclosed
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran in braces and terminated with a semi-colon. Clauses in
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran the statements are also semi-colon terminated. The usual
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran comment styles are supported:
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran C style: /* */
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran C++ style: // to end of line
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran Unix style: # to end of line
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran </refsection>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran <refsection><info><title>ACL</title></info>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoranacl <replaceable>string</replaceable> { <replaceable>address_match_element</replaceable>; ... };
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran</literallayout>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran </refsection>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran <refsection><info><title>KEY</title></info>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcorankey <replaceable>domain_name</replaceable> {
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran algorithm <replaceable>string</replaceable>;
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran</literallayout>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran </refsection>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran <refsection><info><title>MASTERS</title></info>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoranmasters <replaceable>string</replaceable> <optional> port <replaceable>integer</replaceable> </optional> {
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran ( <replaceable>masters</replaceable> | <replaceable>ipv4_address</replaceable> <optional>port <replaceable>integer</replaceable></optional> |
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran <replaceable>ipv6_address</replaceable> <optional>port <replaceable>integer</replaceable></optional> ) <optional> key <replaceable>string</replaceable> </optional>; ...
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran</literallayout>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran </refsection>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran <refsection><info><title>SERVER</title></info>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoranserver ( <replaceable>ipv4_address<optional>/prefixlen</optional></replaceable> | <replaceable>ipv6_address<optional>/prefixlen</optional></replaceable> ) {
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran edns-udp-size <replaceable>integer</replaceable>;
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran max-udp-size <replaceable>integer</replaceable>;
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran tcp-only <replaceable>boolean</replaceable>;
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran provide-ixfr <replaceable>boolean</replaceable>;
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran request-ixfr <replaceable>boolean</replaceable>;
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran keys <replaceable>server_key</replaceable>;
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran transfers <replaceable>integer</replaceable>;
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran transfer-format ( many-answers | one-answer );
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran transfer-source ( <replaceable>ipv4_address</replaceable> | * )
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran <optional> port ( <replaceable>integer</replaceable> | * ) </optional>;
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran transfer-source-v6 ( <replaceable>ipv6_address</replaceable> | * )
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran <optional> port ( <replaceable>integer</replaceable> | * ) </optional>;
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran support-ixfr <replaceable>boolean</replaceable>; // obsolete
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran</literallayout>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran </refsection>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran <refsection><info><title>TRUSTED-KEYS</title></info>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcorantrusted-keys {
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran <replaceable>domain_name</replaceable> <replaceable>flags</replaceable> <replaceable>protocol</replaceable> <replaceable>algorithm</replaceable> <replaceable>key</replaceable>; ...
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran</literallayout>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran </refsection>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran <refsection><info><title>MANAGED-KEYS</title></info>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoranmanaged-keys {
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran <replaceable>domain_name</replaceable> <constant>initial-key</constant> <replaceable>flags</replaceable> <replaceable>protocol</replaceable> <replaceable>algorithm</replaceable> <replaceable>key</replaceable>; ...
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran</literallayout>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran </refsection>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran <refsection><info><title>CONTROLS</title></info>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran inet ( <replaceable>ipv4_address</replaceable> | <replaceable>ipv6_address</replaceable> | * )
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran <optional> port ( <replaceable>integer</replaceable> | * ) </optional>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran allow { <replaceable>address_match_element</replaceable>; ... }
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran <optional> keys { <replaceable>string</replaceable>; ... } </optional>;
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran unix <replaceable>unsupported</replaceable>; // not implemented
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran</literallayout>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran </refsection>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran <refsection><info><title>LOGGING</title></info>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran channel <replaceable>string</replaceable> {
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran syslog <replaceable>optional_facility</replaceable>;
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran severity <replaceable>log_severity</replaceable>;
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran print-time <replaceable>boolean</replaceable>;
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran print-severity <replaceable>boolean</replaceable>;
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran print-category <replaceable>boolean</replaceable>;
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran category <replaceable>string</replaceable> { <replaceable>string</replaceable>; ... };
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran</literallayout>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran </refsection>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran <refsection><info><title>LWRES</title></info>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran listen-on <optional> port <replaceable>integer</replaceable> </optional> {
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran ( <replaceable>ipv4_address</replaceable> | <replaceable>ipv6_address</replaceable> ) <optional> port <replaceable>integer</replaceable> </optional>; ...
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran view <replaceable>string</replaceable> <replaceable>optional_class</replaceable>;
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran search { <replaceable>string</replaceable>; ... };
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran lwres-tasks <replaceable>integer</replaceable>;
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran lwres-clients <replaceable>integer</replaceable>;
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran</literallayout>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran </refsection>
b72d5b75fd6f5bb08d29f65652d60058fc3a2608Michael Corcoran <refsection><info><title>OPTIONS</title></info>
listen-on <optional> port <replaceable>integer</replaceable> </optional> { <replaceable>address_match_element</replaceable>; ... };
listen-on-v6 <optional> port <replaceable>integer</replaceable> </optional> { <replaceable>address_match_element</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>;
dnssec-lookaside ( <replaceable>auto</replaceable> | <replaceable>no</replaceable> | <replaceable>domain</replaceable> trust-anchor <replaceable>domain</replaceable> );
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>; ...
cookie-algorithm ( <replaceable>aes</replaceable> | <replaceable>sha1</replaceable> | <replaceable>sha256</replaceable> );
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>;
dnssec-lookaside ( <replaceable>auto</replaceable> | <replaceable>no</replaceable> | <replaceable>domain</replaceable> trust-anchor <replaceable>domain</replaceable> );
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>; ...