2 - Copyright (C) 2004-2008 Internet Systems Consortium, Inc. ("ISC")
4 - Permission to use, copy, modify, and distribute this software for any
5 - purpose with or without fee is hereby granted, provided that the above
6 - copyright notice and this permission notice appear in all copies.
8 - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
9 - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
10 - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
11 - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
12 - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
13 - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
14 - PERFORMANCE OF THIS SOFTWARE.
16 <!-- $Id: named.conf.html,v 1.1.2.36 2008/09/05 01:32:08 tbox Exp $ -->
19 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
20 <title>named.conf</title>
21 <meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
23 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en">
24 <a name="id2476275"></a><div class="titlepage"></div>
25 <div class="refnamediv">
27 <p><code class="filename">named.conf</code> — configuration file for named</p>
29 <div class="refsynopsisdiv">
31 <div class="cmdsynopsis"><p><code class="command">named.conf</code> </p></div>
33 <div class="refsect1" lang="en">
34 <a name="id2543342"></a><h2>DESCRIPTION</h2>
35 <p><code class="filename">named.conf</code> is the configuration file
37 <span><strong class="command">named</strong></span>. Statements are enclosed
38 in braces and terminated with a semi-colon. Clauses in
39 the statements are also semi-colon terminated. The usual
40 comment styles are supported:
46 C++ style: // to end of line
49 Unix style: # to end of line
52 <div class="refsect1" lang="en">
53 <a name="id2543370"></a><h2>ACL</h2>
54 <div class="literallayout"><p><br>
55 acl <em class="replaceable"><code>string</code></em> { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
59 <div class="refsect1" lang="en">
60 <a name="id2543386"></a><h2>KEY</h2>
61 <div class="literallayout"><p><br>
62 key <em class="replaceable"><code>domain_name</code></em> {<br>
63 algorithm <em class="replaceable"><code>string</code></em>;<br>
64 secret <em class="replaceable"><code>string</code></em>;<br>
68 <div class="refsect1" lang="en">
69 <a name="id2543405"></a><h2>MASTERS</h2>
70 <div class="literallayout"><p><br>
71 masters <em class="replaceable"><code>string</code></em> [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>] {<br>
72 ( <em class="replaceable"><code>masters</code></em> | <em class="replaceable"><code>ipv4_address</code></em> [<span class="optional">port <em class="replaceable"><code>integer</code></em></span>] |<br>
73 <em class="replaceable"><code>ipv6_address</code></em> [<span class="optional">port <em class="replaceable"><code>integer</code></em></span>] ) [<span class="optional"> key <em class="replaceable"><code>string</code></em> </span>]; ...<br>
77 <div class="refsect1" lang="en">
78 <a name="id2543451"></a><h2>SERVER</h2>
79 <div class="literallayout"><p><br>
80 server ( <em class="replaceable"><code>ipv4_address[<span class="optional">/prefixlen</span>]</code></em> | <em class="replaceable"><code>ipv6_address[<span class="optional">/prefixlen</span>]</code></em> ) {<br>
81 bogus <em class="replaceable"><code>boolean</code></em>;<br>
82 edns <em class="replaceable"><code>boolean</code></em>;<br>
83 edns-udp-size <em class="replaceable"><code>integer</code></em>;<br>
84 max-udp-size <em class="replaceable"><code>integer</code></em>;<br>
85 provide-ixfr <em class="replaceable"><code>boolean</code></em>;<br>
86 request-ixfr <em class="replaceable"><code>boolean</code></em>;<br>
87 keys <em class="replaceable"><code>server_key</code></em>;<br>
88 transfers <em class="replaceable"><code>integer</code></em>;<br>
89 transfer-format ( many-answers | one-answer );<br>
90 transfer-source ( <em class="replaceable"><code>ipv4_address</code></em> | * )<br>
91 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
92 transfer-source-v6 ( <em class="replaceable"><code>ipv6_address</code></em> | * )<br>
93 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
95 support-ixfr <em class="replaceable"><code>boolean</code></em>; // obsolete<br>
99 <div class="refsect1" lang="en">
100 <a name="id2543520"></a><h2>TRUSTED-KEYS</h2>
101 <div class="literallayout"><p><br>
103 <em class="replaceable"><code>domain_name</code></em> <em class="replaceable"><code>flags</code></em> <em class="replaceable"><code>protocol</code></em> <em class="replaceable"><code>algorithm</code></em> <em class="replaceable"><code>key</code></em>; ... <br>
107 <div class="refsect1" lang="en">
108 <a name="id2543545"></a><h2>CONTROLS</h2>
109 <div class="literallayout"><p><br>
111 inet ( <em class="replaceable"><code>ipv4_address</code></em> | <em class="replaceable"><code>ipv6_address</code></em> | * )<br>
112 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>]<br>
113 allow { <em class="replaceable"><code>address_match_element</code></em>; ... }<br>
114 [<span class="optional"> keys { <em class="replaceable"><code>string</code></em>; ... } </span>];<br>
115 unix <em class="replaceable"><code>unsupported</code></em>; // not implemented<br>
119 <div class="refsect1" lang="en">
120 <a name="id2543580"></a><h2>LOGGING</h2>
121 <div class="literallayout"><p><br>
123 channel <em class="replaceable"><code>string</code></em> {<br>
124 file <em class="replaceable"><code>log_file</code></em>;<br>
125 syslog <em class="replaceable"><code>optional_facility</code></em>;<br>
128 severity <em class="replaceable"><code>log_severity</code></em>;<br>
129 print-time <em class="replaceable"><code>boolean</code></em>;<br>
130 print-severity <em class="replaceable"><code>boolean</code></em>;<br>
131 print-category <em class="replaceable"><code>boolean</code></em>;<br>
133 category <em class="replaceable"><code>string</code></em> { <em class="replaceable"><code>string</code></em>; ... };<br>
137 <div class="refsect1" lang="en">
138 <a name="id2543619"></a><h2>LWRES</h2>
139 <div class="literallayout"><p><br>
141 listen-on [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>] {<br>
142 ( <em class="replaceable"><code>ipv4_address</code></em> | <em class="replaceable"><code>ipv6_address</code></em> ) [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>]; ...<br>
144 view <em class="replaceable"><code>string</code></em> <em class="replaceable"><code>optional_class</code></em>;<br>
145 search { <em class="replaceable"><code>string</code></em>; ... };<br>
146 ndots <em class="replaceable"><code>integer</code></em>;<br>
150 <div class="refsect1" lang="en">
151 <a name="id2543660"></a><h2>OPTIONS</h2>
152 <div class="literallayout"><p><br>
154 avoid-v4-udp-ports { <em class="replaceable"><code>port</code></em>; ... };<br>
155 avoid-v6-udp-ports { <em class="replaceable"><code>port</code></em>; ... };<br>
156 blackhole { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
157 coresize <em class="replaceable"><code>size</code></em>;<br>
158 datasize <em class="replaceable"><code>size</code></em>;<br>
159 directory <em class="replaceable"><code>quoted_string</code></em>;<br>
160 dump-file <em class="replaceable"><code>quoted_string</code></em>;<br>
161 files <em class="replaceable"><code>size</code></em>;<br>
162 heartbeat-interval <em class="replaceable"><code>integer</code></em>;<br>
163 host-statistics <em class="replaceable"><code>boolean</code></em>; // not implemented<br>
164 host-statistics-max <em class="replaceable"><code>number</code></em>; // not implemented<br>
165 hostname ( <em class="replaceable"><code>quoted_string</code></em> | none );<br>
166 interface-interval <em class="replaceable"><code>integer</code></em>;<br>
167 listen-on [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>] { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
168 listen-on-v6 [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>] { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
169 match-mapped-addresses <em class="replaceable"><code>boolean</code></em>;<br>
170 memstatistics-file <em class="replaceable"><code>quoted_string</code></em>;<br>
171 pid-file ( <em class="replaceable"><code>quoted_string</code></em> | none );<br>
172 port <em class="replaceable"><code>integer</code></em>;<br>
173 querylog <em class="replaceable"><code>boolean</code></em>;<br>
174 recursing-file <em class="replaceable"><code>quoted_string</code></em>;<br>
175 reserved-sockets <em class="replaceable"><code>integer</code></em>;<br>
176 random-device <em class="replaceable"><code>quoted_string</code></em>;<br>
177 recursive-clients <em class="replaceable"><code>integer</code></em>;<br>
178 serial-query-rate <em class="replaceable"><code>integer</code></em>;<br>
179 server-id ( <em class="replaceable"><code>quoted_string</code></em> | none |;<br>
180 stacksize <em class="replaceable"><code>size</code></em>;<br>
181 statistics-file <em class="replaceable"><code>quoted_string</code></em>;<br>
182 statistics-interval <em class="replaceable"><code>integer</code></em>; // not yet implemented<br>
183 tcp-clients <em class="replaceable"><code>integer</code></em>;<br>
184 tcp-listen-queue <em class="replaceable"><code>integer</code></em>;<br>
185 tkey-dhkey <em class="replaceable"><code>quoted_string</code></em> <em class="replaceable"><code>integer</code></em>;<br>
186 tkey-gssapi-credential <em class="replaceable"><code>quoted_string</code></em>;<br>
187 tkey-domain <em class="replaceable"><code>quoted_string</code></em>;<br>
188 transfers-per-ns <em class="replaceable"><code>integer</code></em>;<br>
189 transfers-in <em class="replaceable"><code>integer</code></em>;<br>
190 transfers-out <em class="replaceable"><code>integer</code></em>;<br>
191 use-ixfr <em class="replaceable"><code>boolean</code></em>;<br>
192 version ( <em class="replaceable"><code>quoted_string</code></em> | none );<br>
193 allow-recursion { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
194 sortlist { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
195 topology { <em class="replaceable"><code>address_match_element</code></em>; ... }; // not implemented<br>
196 auth-nxdomain <em class="replaceable"><code>boolean</code></em>; // default changed<br>
197 minimal-responses <em class="replaceable"><code>boolean</code></em>;<br>
198 recursion <em class="replaceable"><code>boolean</code></em>;<br>
200 [<span class="optional"> class <em class="replaceable"><code>string</code></em> </span>] [<span class="optional"> type <em class="replaceable"><code>string</code></em> </span>]<br>
201 [<span class="optional"> name <em class="replaceable"><code>quoted_string</code></em> </span>] <em class="replaceable"><code>string</code></em> <em class="replaceable"><code>string</code></em>; ...<br>
203 provide-ixfr <em class="replaceable"><code>boolean</code></em>;<br>
204 request-ixfr <em class="replaceable"><code>boolean</code></em>;<br>
205 rfc2308-type1 <em class="replaceable"><code>boolean</code></em>; // not yet implemented<br>
206 additional-from-auth <em class="replaceable"><code>boolean</code></em>;<br>
207 additional-from-cache <em class="replaceable"><code>boolean</code></em>;<br>
208 query-source ( ( <em class="replaceable"><code>ipv4_address</code></em> | * ) | [<span class="optional"> address ( <em class="replaceable"><code>ipv4_address</code></em> | * ) </span>] ) [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
209 query-source-v6 ( ( <em class="replaceable"><code>ipv6_address</code></em> | * ) | [<span class="optional"> address ( <em class="replaceable"><code>ipv6_address</code></em> | * ) </span>] ) [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
210 cleaning-interval <em class="replaceable"><code>integer</code></em>;<br>
211 min-roots <em class="replaceable"><code>integer</code></em>; // not implemented<br>
212 lame-ttl <em class="replaceable"><code>integer</code></em>;<br>
213 max-ncache-ttl <em class="replaceable"><code>integer</code></em>;<br>
214 max-cache-ttl <em class="replaceable"><code>integer</code></em>;<br>
215 transfer-format ( many-answers | one-answer );<br>
216 max-cache-size <em class="replaceable"><code>size_no_default</code></em>;<br>
217 max-acache-size <em class="replaceable"><code>size_no_default</code></em>;<br>
218 clients-per-query <em class="replaceable"><code>number</code></em>;<br>
219 max-clients-per-query <em class="replaceable"><code>number</code></em>;<br>
220 check-names ( master | slave | response )<br>
221 ( fail | warn | ignore );<br>
222 check-mx ( fail | warn | ignore );<br>
223 check-integrity <em class="replaceable"><code>boolean</code></em>;<br>
224 check-mx-cname ( fail | warn | ignore );<br>
225 check-srv-cname ( fail | warn | ignore );<br>
226 cache-file <em class="replaceable"><code>quoted_string</code></em>; // test option<br>
227 suppress-initial-notify <em class="replaceable"><code>boolean</code></em>; // not yet implemented<br>
228 preferred-glue <em class="replaceable"><code>string</code></em>;<br>
229 dual-stack-servers [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>] {<br>
230 ( <em class="replaceable"><code>quoted_string</code></em> [<span class="optional">port <em class="replaceable"><code>integer</code></em></span>] |<br>
231 <em class="replaceable"><code>ipv4_address</code></em> [<span class="optional">port <em class="replaceable"><code>integer</code></em></span>] |<br>
232 <em class="replaceable"><code>ipv6_address</code></em> [<span class="optional">port <em class="replaceable"><code>integer</code></em></span>] ); ...<br>
234 edns-udp-size <em class="replaceable"><code>integer</code></em>;<br>
235 max-udp-size <em class="replaceable"><code>integer</code></em>;<br>
236 root-delegation-only [<span class="optional"> exclude { <em class="replaceable"><code>quoted_string</code></em>; ... } </span>];<br>
237 disable-algorithms <em class="replaceable"><code>string</code></em> { <em class="replaceable"><code>string</code></em>; ... };<br>
238 dnssec-enable <em class="replaceable"><code>boolean</code></em>;<br>
239 dnssec-validation <em class="replaceable"><code>boolean</code></em>;<br>
240 dnssec-lookaside <em class="replaceable"><code>string</code></em> trust-anchor <em class="replaceable"><code>string</code></em>;<br>
241 dnssec-must-be-secure <em class="replaceable"><code>string</code></em> <em class="replaceable"><code>boolean</code></em>;<br>
242 dnssec-accept-expired <em class="replaceable"><code>boolean</code></em>;<br>
244 empty-server <em class="replaceable"><code>string</code></em>;<br>
245 empty-contact <em class="replaceable"><code>string</code></em>;<br>
246 empty-zones-enable <em class="replaceable"><code>boolean</code></em>;<br>
247 disable-empty-zone <em class="replaceable"><code>string</code></em>;<br>
249 dialup <em class="replaceable"><code>dialuptype</code></em>;<br>
250 ixfr-from-differences <em class="replaceable"><code>ixfrdiff</code></em>;<br>
252 allow-query { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
253 allow-query-cache { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
254 allow-transfer { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
255 allow-update { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
256 allow-update-forwarding { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
257 update-check-ksk <em class="replaceable"><code>boolean</code></em>;<br>
259 masterfile-format ( text | raw );<br>
260 notify <em class="replaceable"><code>notifytype</code></em>;<br>
261 notify-source ( <em class="replaceable"><code>ipv4_address</code></em> | * ) [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
262 notify-source-v6 ( <em class="replaceable"><code>ipv6_address</code></em> | * ) [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
263 notify-delay <em class="replaceable"><code>seconds</code></em>;<br>
264 also-notify [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>] { ( <em class="replaceable"><code>ipv4_address</code></em> | <em class="replaceable"><code>ipv6_address</code></em> )<br>
265 [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>]; ... };<br>
266 allow-notify { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
268 forward ( first | only );<br>
269 forwarders [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>] {<br>
270 ( <em class="replaceable"><code>ipv4_address</code></em> | <em class="replaceable"><code>ipv6_address</code></em> ) [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>]; ...<br>
273 max-journal-size <em class="replaceable"><code>size_no_default</code></em>;<br>
274 max-transfer-time-in <em class="replaceable"><code>integer</code></em>;<br>
275 max-transfer-time-out <em class="replaceable"><code>integer</code></em>;<br>
276 max-transfer-idle-in <em class="replaceable"><code>integer</code></em>;<br>
277 max-transfer-idle-out <em class="replaceable"><code>integer</code></em>;<br>
278 max-retry-time <em class="replaceable"><code>integer</code></em>;<br>
279 min-retry-time <em class="replaceable"><code>integer</code></em>;<br>
280 max-refresh-time <em class="replaceable"><code>integer</code></em>;<br>
281 min-refresh-time <em class="replaceable"><code>integer</code></em>;<br>
282 multi-master <em class="replaceable"><code>boolean</code></em>;<br>
283 sig-validity-interval <em class="replaceable"><code>integer</code></em>;<br>
285 transfer-source ( <em class="replaceable"><code>ipv4_address</code></em> | * )<br>
286 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
287 transfer-source-v6 ( <em class="replaceable"><code>ipv6_address</code></em> | * )<br>
288 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
290 alt-transfer-source ( <em class="replaceable"><code>ipv4_address</code></em> | * )<br>
291 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
292 alt-transfer-source-v6 ( <em class="replaceable"><code>ipv6_address</code></em> | * )<br>
293 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
294 use-alt-transfer-source <em class="replaceable"><code>boolean</code></em>;<br>
296 zone-statistics <em class="replaceable"><code>boolean</code></em>;<br>
297 key-directory <em class="replaceable"><code>quoted_string</code></em>;<br>
298 zero-no-soa-ttl <em class="replaceable"><code>boolean</code></em>;<br>
299 zero-no-soa-ttl-cache <em class="replaceable"><code>boolean</code></em>;<br>
301 allow-v6-synthesis { <em class="replaceable"><code>address_match_element</code></em>; ... }; // obsolete<br>
302 deallocate-on-exit <em class="replaceable"><code>boolean</code></em>; // obsolete<br>
303 fake-iquery <em class="replaceable"><code>boolean</code></em>; // obsolete<br>
304 fetch-glue <em class="replaceable"><code>boolean</code></em>; // obsolete<br>
305 has-old-clients <em class="replaceable"><code>boolean</code></em>; // obsolete<br>
306 maintain-ixfr-base <em class="replaceable"><code>boolean</code></em>; // obsolete<br>
307 max-ixfr-log-size <em class="replaceable"><code>size</code></em>; // obsolete<br>
308 multiple-cnames <em class="replaceable"><code>boolean</code></em>; // obsolete<br>
309 named-xfer <em class="replaceable"><code>quoted_string</code></em>; // obsolete<br>
310 serial-queries <em class="replaceable"><code>integer</code></em>; // obsolete<br>
311 treat-cr-as-space <em class="replaceable"><code>boolean</code></em>; // obsolete<br>
312 use-id-pool <em class="replaceable"><code>boolean</code></em>; // obsolete<br>
316 <div class="refsect1" lang="en">
317 <a name="id2544407"></a><h2>VIEW</h2>
318 <div class="literallayout"><p><br>
319 view <em class="replaceable"><code>string</code></em> <em class="replaceable"><code>optional_class</code></em> {<br>
320 match-clients { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
321 match-destinations { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
322 match-recursive-only <em class="replaceable"><code>boolean</code></em>;<br>
324 key <em class="replaceable"><code>string</code></em> {<br>
325 algorithm <em class="replaceable"><code>string</code></em>;<br>
326 secret <em class="replaceable"><code>string</code></em>;<br>
329 zone <em class="replaceable"><code>string</code></em> <em class="replaceable"><code>optional_class</code></em> {<br>
333 server ( <em class="replaceable"><code>ipv4_address[<span class="optional">/prefixlen</span>]</code></em> | <em class="replaceable"><code>ipv6_address[<span class="optional">/prefixlen</span>]</code></em> ) {<br>
338 <em class="replaceable"><code>string</code></em> <em class="replaceable"><code>integer</code></em> <em class="replaceable"><code>integer</code></em> <em class="replaceable"><code>integer</code></em> <em class="replaceable"><code>quoted_string</code></em>; ...<br>
341 allow-recursion { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
342 sortlist { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
343 topology { <em class="replaceable"><code>address_match_element</code></em>; ... }; // not implemented<br>
344 auth-nxdomain <em class="replaceable"><code>boolean</code></em>; // default changed<br>
345 minimal-responses <em class="replaceable"><code>boolean</code></em>;<br>
346 recursion <em class="replaceable"><code>boolean</code></em>;<br>
348 [<span class="optional"> class <em class="replaceable"><code>string</code></em> </span>] [<span class="optional"> type <em class="replaceable"><code>string</code></em> </span>]<br>
349 [<span class="optional"> name <em class="replaceable"><code>quoted_string</code></em> </span>] <em class="replaceable"><code>string</code></em> <em class="replaceable"><code>string</code></em>; ...<br>
351 provide-ixfr <em class="replaceable"><code>boolean</code></em>;<br>
352 request-ixfr <em class="replaceable"><code>boolean</code></em>;<br>
353 rfc2308-type1 <em class="replaceable"><code>boolean</code></em>; // not yet implemented<br>
354 additional-from-auth <em class="replaceable"><code>boolean</code></em>;<br>
355 additional-from-cache <em class="replaceable"><code>boolean</code></em>;<br>
356 query-source ( ( <em class="replaceable"><code>ipv4_address</code></em> | * ) | [<span class="optional"> address ( <em class="replaceable"><code>ipv4_address</code></em> | * ) </span>] ) [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
357 query-source-v6 ( ( <em class="replaceable"><code>ipv6_address</code></em> | * ) | [<span class="optional"> address ( <em class="replaceable"><code>ipv6_address</code></em> | * ) </span>] ) [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
358 cleaning-interval <em class="replaceable"><code>integer</code></em>;<br>
359 min-roots <em class="replaceable"><code>integer</code></em>; // not implemented<br>
360 lame-ttl <em class="replaceable"><code>integer</code></em>;<br>
361 max-ncache-ttl <em class="replaceable"><code>integer</code></em>;<br>
362 max-cache-ttl <em class="replaceable"><code>integer</code></em>;<br>
363 transfer-format ( many-answers | one-answer );<br>
364 max-cache-size <em class="replaceable"><code>size_no_default</code></em>;<br>
365 max-acache-size <em class="replaceable"><code>size_no_default</code></em>;<br>
366 clients-per-query <em class="replaceable"><code>number</code></em>;<br>
367 max-clients-per-query <em class="replaceable"><code>number</code></em>;<br>
368 check-names ( master | slave | response )<br>
369 ( fail | warn | ignore );<br>
370 check-mx ( fail | warn | ignore );<br>
371 check-integrity <em class="replaceable"><code>boolean</code></em>;<br>
372 check-mx-cname ( fail | warn | ignore );<br>
373 check-srv-cname ( fail | warn | ignore );<br>
374 cache-file <em class="replaceable"><code>quoted_string</code></em>; // test option<br>
375 suppress-initial-notify <em class="replaceable"><code>boolean</code></em>; // not yet implemented<br>
376 preferred-glue <em class="replaceable"><code>string</code></em>;<br>
377 dual-stack-servers [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>] {<br>
378 ( <em class="replaceable"><code>quoted_string</code></em> [<span class="optional">port <em class="replaceable"><code>integer</code></em></span>] |<br>
379 <em class="replaceable"><code>ipv4_address</code></em> [<span class="optional">port <em class="replaceable"><code>integer</code></em></span>] |<br>
380 <em class="replaceable"><code>ipv6_address</code></em> [<span class="optional">port <em class="replaceable"><code>integer</code></em></span>] ); ...<br>
382 edns-udp-size <em class="replaceable"><code>integer</code></em>;<br>
383 max-udp-size <em class="replaceable"><code>integer</code></em>;<br>
384 root-delegation-only [<span class="optional"> exclude { <em class="replaceable"><code>quoted_string</code></em>; ... } </span>];<br>
385 disable-algorithms <em class="replaceable"><code>string</code></em> { <em class="replaceable"><code>string</code></em>; ... };<br>
386 dnssec-enable <em class="replaceable"><code>boolean</code></em>;<br>
387 dnssec-validation <em class="replaceable"><code>boolean</code></em>;<br>
388 dnssec-lookaside <em class="replaceable"><code>string</code></em> trust-anchor <em class="replaceable"><code>string</code></em>;<br>
389 dnssec-must-be-secure <em class="replaceable"><code>string</code></em> <em class="replaceable"><code>boolean</code></em>;<br>
390 dnssec-accept-expired <em class="replaceable"><code>boolean</code></em>;<br>
392 empty-server <em class="replaceable"><code>string</code></em>;<br>
393 empty-contact <em class="replaceable"><code>string</code></em>;<br>
394 empty-zones-enable <em class="replaceable"><code>boolean</code></em>;<br>
395 disable-empty-zone <em class="replaceable"><code>string</code></em>;<br>
397 dialup <em class="replaceable"><code>dialuptype</code></em>;<br>
398 ixfr-from-differences <em class="replaceable"><code>ixfrdiff</code></em>;<br>
400 allow-query { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
401 allow-query-cache { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
402 allow-transfer { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
403 allow-update { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
404 allow-update-forwarding { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
405 update-check-ksk <em class="replaceable"><code>boolean</code></em>;<br>
407 masterfile-format ( text | raw );<br>
408 notify <em class="replaceable"><code>notifytype</code></em>;<br>
409 notify-source ( <em class="replaceable"><code>ipv4_address</code></em> | * ) [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
410 notify-source-v6 ( <em class="replaceable"><code>ipv6_address</code></em> | * ) [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
411 notify-delay <em class="replaceable"><code>seconds</code></em>;<br>
412 also-notify [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>] { ( <em class="replaceable"><code>ipv4_address</code></em> | <em class="replaceable"><code>ipv6_address</code></em> )<br>
413 [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>]; ... };<br>
414 allow-notify { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
416 forward ( first | only );<br>
417 forwarders [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>] {<br>
418 ( <em class="replaceable"><code>ipv4_address</code></em> | <em class="replaceable"><code>ipv6_address</code></em> ) [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>]; ...<br>
421 max-journal-size <em class="replaceable"><code>size_no_default</code></em>;<br>
422 max-transfer-time-in <em class="replaceable"><code>integer</code></em>;<br>
423 max-transfer-time-out <em class="replaceable"><code>integer</code></em>;<br>
424 max-transfer-idle-in <em class="replaceable"><code>integer</code></em>;<br>
425 max-transfer-idle-out <em class="replaceable"><code>integer</code></em>;<br>
426 max-retry-time <em class="replaceable"><code>integer</code></em>;<br>
427 min-retry-time <em class="replaceable"><code>integer</code></em>;<br>
428 max-refresh-time <em class="replaceable"><code>integer</code></em>;<br>
429 min-refresh-time <em class="replaceable"><code>integer</code></em>;<br>
430 multi-master <em class="replaceable"><code>boolean</code></em>;<br>
431 sig-validity-interval <em class="replaceable"><code>integer</code></em>;<br>
433 transfer-source ( <em class="replaceable"><code>ipv4_address</code></em> | * )<br>
434 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
435 transfer-source-v6 ( <em class="replaceable"><code>ipv6_address</code></em> | * )<br>
436 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
438 alt-transfer-source ( <em class="replaceable"><code>ipv4_address</code></em> | * )<br>
439 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
440 alt-transfer-source-v6 ( <em class="replaceable"><code>ipv6_address</code></em> | * )<br>
441 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
442 use-alt-transfer-source <em class="replaceable"><code>boolean</code></em>;<br>
444 zone-statistics <em class="replaceable"><code>boolean</code></em>;<br>
445 key-directory <em class="replaceable"><code>quoted_string</code></em>;<br>
446 zero-no-soa-ttl <em class="replaceable"><code>boolean</code></em>;<br>
447 zero-no-soa-ttl-cache <em class="replaceable"><code>boolean</code></em>;<br>
449 allow-v6-synthesis { <em class="replaceable"><code>address_match_element</code></em>; ... }; // obsolete<br>
450 fetch-glue <em class="replaceable"><code>boolean</code></em>; // obsolete<br>
451 maintain-ixfr-base <em class="replaceable"><code>boolean</code></em>; // obsolete<br>
452 max-ixfr-log-size <em class="replaceable"><code>size</code></em>; // obsolete<br>
456 <div class="refsect1" lang="en">
457 <a name="id2544972"></a><h2>ZONE</h2>
458 <div class="literallayout"><p><br>
459 zone <em class="replaceable"><code>string</code></em> <em class="replaceable"><code>optional_class</code></em> {<br>
460 type ( master | slave | stub | hint |<br>
461 forward | delegation-only );<br>
462 file <em class="replaceable"><code>quoted_string</code></em>;<br>
464 masters [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>] {<br>
465 ( <em class="replaceable"><code>masters</code></em> |<br>
466 <em class="replaceable"><code>ipv4_address</code></em> [<span class="optional">port <em class="replaceable"><code>integer</code></em></span>] |<br>
467 <em class="replaceable"><code>ipv6_address</code></em> [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>] ) [<span class="optional"> key <em class="replaceable"><code>string</code></em> </span>]; ...<br>
470 database <em class="replaceable"><code>string</code></em>;<br>
471 delegation-only <em class="replaceable"><code>boolean</code></em>;<br>
472 check-names ( fail | warn | ignore );<br>
473 check-mx ( fail | warn | ignore );<br>
474 check-integrity <em class="replaceable"><code>boolean</code></em>;<br>
475 check-mx-cname ( fail | warn | ignore );<br>
476 check-srv-cname ( fail | warn | ignore );<br>
477 dialup <em class="replaceable"><code>dialuptype</code></em>;<br>
478 ixfr-from-differences <em class="replaceable"><code>boolean</code></em>;<br>
479 journal <em class="replaceable"><code>quoted_string</code></em>;<br>
480 zero-no-soa-ttl <em class="replaceable"><code>boolean</code></em>;<br>
482 allow-query { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
483 allow-transfer { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
484 allow-update { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
485 allow-update-forwarding { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
487 ( grant | deny ) <em class="replaceable"><code>string</code></em><br>
488 ( name | subdomain | wildcard | self ) <em class="replaceable"><code>string</code></em><br>
489 <em class="replaceable"><code>rrtypelist</code></em>; ...<br>
491 update-check-ksk <em class="replaceable"><code>boolean</code></em>;<br>
493 masterfile-format ( text | raw );<br>
494 notify <em class="replaceable"><code>notifytype</code></em>;<br>
495 notify-source ( <em class="replaceable"><code>ipv4_address</code></em> | * ) [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
496 notify-source-v6 ( <em class="replaceable"><code>ipv6_address</code></em> | * ) [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
497 notify-delay <em class="replaceable"><code>seconds</code></em>;<br>
498 also-notify [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>] { ( <em class="replaceable"><code>ipv4_address</code></em> | <em class="replaceable"><code>ipv6_address</code></em> )<br>
499 [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>]; ... };<br>
500 allow-notify { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
502 forward ( first | only );<br>
503 forwarders [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>] {<br>
504 ( <em class="replaceable"><code>ipv4_address</code></em> | <em class="replaceable"><code>ipv6_address</code></em> ) [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>]; ...<br>
507 max-journal-size <em class="replaceable"><code>size_no_default</code></em>;<br>
508 max-transfer-time-in <em class="replaceable"><code>integer</code></em>;<br>
509 max-transfer-time-out <em class="replaceable"><code>integer</code></em>;<br>
510 max-transfer-idle-in <em class="replaceable"><code>integer</code></em>;<br>
511 max-transfer-idle-out <em class="replaceable"><code>integer</code></em>;<br>
512 max-retry-time <em class="replaceable"><code>integer</code></em>;<br>
513 min-retry-time <em class="replaceable"><code>integer</code></em>;<br>
514 max-refresh-time <em class="replaceable"><code>integer</code></em>;<br>
515 min-refresh-time <em class="replaceable"><code>integer</code></em>;<br>
516 multi-master <em class="replaceable"><code>boolean</code></em>;<br>
517 sig-validity-interval <em class="replaceable"><code>integer</code></em>;<br>
519 transfer-source ( <em class="replaceable"><code>ipv4_address</code></em> | * )<br>
520 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
521 transfer-source-v6 ( <em class="replaceable"><code>ipv6_address</code></em> | * )<br>
522 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
524 alt-transfer-source ( <em class="replaceable"><code>ipv4_address</code></em> | * )<br>
525 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
526 alt-transfer-source-v6 ( <em class="replaceable"><code>ipv6_address</code></em> | * )<br>
527 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
528 use-alt-transfer-source <em class="replaceable"><code>boolean</code></em>;<br>
530 zone-statistics <em class="replaceable"><code>boolean</code></em>;<br>
531 key-directory <em class="replaceable"><code>quoted_string</code></em>;<br>
533 ixfr-base <em class="replaceable"><code>quoted_string</code></em>; // obsolete<br>
534 ixfr-tmp-file <em class="replaceable"><code>quoted_string</code></em>; // obsolete<br>
535 maintain-ixfr-base <em class="replaceable"><code>boolean</code></em>; // obsolete<br>
536 max-ixfr-log-size <em class="replaceable"><code>size</code></em>; // obsolete<br>
537 pubkey <em class="replaceable"><code>integer</code></em> <em class="replaceable"><code>integer</code></em> <em class="replaceable"><code>integer</code></em> <em class="replaceable"><code>quoted_string</code></em>; // obsolete<br>
541 <div class="refsect1" lang="en">
542 <a name="id2545325"></a><h2>FILES</h2>
543 <p><code class="filename">/etc/named.conf</code>
546 <div class="refsect1" lang="en">
547 <a name="id2545337"></a><h2>SEE ALSO</h2>
548 <p><span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>,
549 <span class="citerefentry"><span class="refentrytitle">named-checkconf</span>(8)</span>,
550 <span class="citerefentry"><span class="refentrytitle">rndc</span>(8)</span>,
551 <em class="citetitle">BIND 9 Administrator Reference Manual</em>.