named.conf.docbook revision 1da14e066c23245c255dedb311d5a9cf0e5bb667
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
135bcc2e42a94543f11af2a4196b13552ab46d89Automatic Updater "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
499b34cea04a46823d003d4c0520c8b03e8513cbBrian Wellington [<!ENTITY mdash "—">]>
ec5347e2c775f027573ce5648b910361aa926c01Automatic Updater - Copyright (C) 2004-2008 Internet Systems Consortium, Inc. ("ISC")
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson - Permission to use, copy, modify, and/or distribute this software for any
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence - purpose with or without fee is hereby granted, provided that the above
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - copyright notice and this permission notice appear in all copies.
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson - PERFORMANCE OF THIS SOFTWARE.
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein<!-- $Id: named.conf.docbook,v 1.36 2008/01/02 23:47:01 tbox Exp $ -->
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson <refentryinfo>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson </refentryinfo>
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence <refentrytitle><filename>named.conf</filename></refentrytitle>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson <refname><filename>named.conf</filename></refname>
7dde2780aeae0da4e965d823578a604d8ce1215fAndreas Gustafsson <refpurpose>configuration file for named</refpurpose>
45e1bd63587102c3bb361eaca42ee7b714fb3542Mark Andrews <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
45e1bd63587102c3bb361eaca42ee7b714fb3542Mark Andrews </copyright>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson <refsynopsisdiv>
fb01226bcd598c36b5edc566489c890c39f03ed3Brian Wellington </cmdsynopsis>
c6d4f781529d2f28693546b25b2967d44ec89e60Mark Andrews </refsynopsisdiv>
90c099e88e9f16bfee9edee3ac1a51fc98843772Brian Wellington <para><filename>named.conf</filename> is the configuration file
45e1bd63587102c3bb361eaca42ee7b714fb3542Mark Andrews <command>named</command>. Statements are enclosed
45e1bd63587102c3bb361eaca42ee7b714fb3542Mark Andrews in braces and terminated with a semi-colon. Clauses in
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson the statements are also semi-colon terminated. The usual
90c099e88e9f16bfee9edee3ac1a51fc98843772Brian Wellington comment styles are supported:
90c099e88e9f16bfee9edee3ac1a51fc98843772Brian Wellington C style: /* */
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson C++ style: // to end of line
90c099e88e9f16bfee9edee3ac1a51fc98843772Brian Wellington Unix style: # to end of line
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson <literallayout>
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrenceacl <replaceable>string</replaceable> { <replaceable>address_match_element</replaceable>; ... };
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence</literallayout>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson <literallayout>
307d2084502eddc7ce921e5ce439aec3531d90e0Tatuya JINMEI 神明達哉key <replaceable>domain_name</replaceable> {
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson algorithm <replaceable>string</replaceable>;
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson secret <replaceable>string</replaceable>;
1a69a1a78cfaa86f3b68bbc965232b7876d4da2aDavid Lawrence</literallayout>
c6d4f781529d2f28693546b25b2967d44ec89e60Mark Andrews <literallayout>
90c099e88e9f16bfee9edee3ac1a51fc98843772Brian Wellingtonmasters <replaceable>string</replaceable> <optional> port <replaceable>integer</replaceable> </optional> {
c6d4f781529d2f28693546b25b2967d44ec89e60Mark Andrews ( <replaceable>masters</replaceable> | <replaceable>ipv4_address</replaceable> <optional>port <replaceable>integer</replaceable></optional> |
c6d4f781529d2f28693546b25b2967d44ec89e60Mark Andrews <replaceable>ipv6_address</replaceable> <optional>port <replaceable>integer</replaceable></optional> ) <optional> key <replaceable>string</replaceable> </optional>; ...
90c099e88e9f16bfee9edee3ac1a51fc98843772Brian Wellington</literallayout>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson <literallayout>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafssonserver ( <replaceable>ipv4_address<optional>/prefixlen</optional></replaceable> | <replaceable>ipv6_address<optional>/prefixlen</optional></replaceable> ) {
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson bogus <replaceable>boolean</replaceable>;
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson edns-udp-size <replaceable>integer</replaceable>;
6e49e91bd08778d7eae45a2229dcf41ed97cc636David Lawrence max-udp-size <replaceable>integer</replaceable>;
734ae1f7c6abafe1f1ca164aad7a3dd01ee82cbdBrian Wellington provide-ixfr <replaceable>boolean</replaceable>;
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson request-ixfr <replaceable>boolean</replaceable>;
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson keys <replaceable>server_key</replaceable>;
6e49e91bd08778d7eae45a2229dcf41ed97cc636David Lawrence transfers <replaceable>integer</replaceable>;
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson transfer-format ( many-answers | one-answer );
fb01226bcd598c36b5edc566489c890c39f03ed3Brian Wellington transfer-source ( <replaceable>ipv4_address</replaceable> | * )
7a184cd4e5a54a4e530f9bff8a4e46be392d0b52Brian Wellington <optional> port ( <replaceable>integer</replaceable> | * ) </optional>;
fb01226bcd598c36b5edc566489c890c39f03ed3Brian Wellington transfer-source-v6 ( <replaceable>ipv6_address</replaceable> | * )
c6d4f781529d2f28693546b25b2967d44ec89e60Mark Andrews <optional> port ( <replaceable>integer</replaceable> | * ) </optional>;
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson support-ixfr <replaceable>boolean</replaceable>; // obsolete
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson</literallayout>
c6d4f781529d2f28693546b25b2967d44ec89e60Mark Andrews <literallayout>
90c099e88e9f16bfee9edee3ac1a51fc98843772Brian Wellington <replaceable>domain_name</replaceable> <replaceable>flags</replaceable> <replaceable>protocol</replaceable> <replaceable>algorithm</replaceable> <replaceable>key</replaceable>; ...
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson</literallayout>
90c099e88e9f16bfee9edee3ac1a51fc98843772Brian Wellington <literallayout>
9df7d74e421cf715c6e3cbbad2aba6d33a5d1c9bBrian Wellington inet ( <replaceable>ipv4_address</replaceable> | <replaceable>ipv6_address</replaceable> | * )
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson <optional> port ( <replaceable>integer</replaceable> | * ) </optional>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson allow { <replaceable>address_match_element</replaceable>; ... }
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson <optional> keys { <replaceable>string</replaceable>; ... } </optional>;
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson unix <replaceable>unsupported</replaceable>; // not implemented
90c099e88e9f16bfee9edee3ac1a51fc98843772Brian Wellington</literallayout>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson <literallayout>
90c099e88e9f16bfee9edee3ac1a51fc98843772Brian Wellington channel <replaceable>string</replaceable> {
351b62535d4c4f89883bfdba025999dd32490266Evan Hunt syslog <replaceable>optional_facility</replaceable>;
90c099e88e9f16bfee9edee3ac1a51fc98843772Brian Wellington severity <replaceable>log_severity</replaceable>;
90c099e88e9f16bfee9edee3ac1a51fc98843772Brian Wellington print-time <replaceable>boolean</replaceable>;
90c099e88e9f16bfee9edee3ac1a51fc98843772Brian Wellington print-severity <replaceable>boolean</replaceable>;
90c099e88e9f16bfee9edee3ac1a51fc98843772Brian Wellington print-category <replaceable>boolean</replaceable>;
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson category <replaceable>string</replaceable> { <replaceable>string</replaceable>; ... };
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson</literallayout>
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence <literallayout>
90c099e88e9f16bfee9edee3ac1a51fc98843772Brian Wellington listen-on <optional> port <replaceable>integer</replaceable> </optional> {
90c099e88e9f16bfee9edee3ac1a51fc98843772Brian Wellington ( <replaceable>ipv4_address</replaceable> | <replaceable>ipv6_address</replaceable> ) <optional> port <replaceable>integer</replaceable> </optional>; ...
8c7eaac6bbcc9746afe8f57b60bb964745c01eafAndreas Gustafsson view <replaceable>string</replaceable> <replaceable>optional_class</replaceable>;
8c7eaac6bbcc9746afe8f57b60bb964745c01eafAndreas Gustafsson search { <replaceable>string</replaceable>; ... };
8c7eaac6bbcc9746afe8f57b60bb964745c01eafAndreas Gustafsson ndots <replaceable>integer</replaceable>;
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson</literallayout>
f93d33e24fdf76eb2558168f018b8992bcfc5681Andreas Gustafsson <literallayout>
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>;
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>; ...