Merge from vendor branch LESS:
[dragonfly.git] / contrib / bind-9.3 / bin / named / named.conf.html
1 <!--
2  - Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC")
3  - 
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.
7  - 
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.
15 -->
16 <!-- $Id: named.conf.html,v 1.1.4.10 2005/10/13 02:33:48 marka Exp $ -->
17 <html>
18 <head>
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.69.1">
22 </head>
23 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en">
24 <a name="id2463721"></a><div class="titlepage"></div>
25 <div class="refnamediv">
26 <h2>Name</h2>
27 <p><code class="filename">named.conf</code> &#8212; configuration file for named</p>
28 </div>
29 <div class="refsynopsisdiv">
30 <h2>Synopsis</h2>
31 <div class="cmdsynopsis"><p><code class="command">named.conf</code> </p></div>
32 </div>
33 <div class="refsect1" lang="en">
34 <a name="id2525889"></a><h2>DESCRIPTION</h2>
35 <p>
36         <code class="filename">named.conf</code> is the configuration file for
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:
41     </p>
42 <p>
43         C style: /* */
44     </p>
45 <p>
46         C++ style: // to end of line
47     </p>
48 <p>
49         Unix style: # to end of line
50     </p>
51 </div>
52 <div class="refsect1" lang="en">
53 <a name="id2525917"></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>
56 <br>
57 </p></div>
58 </div>
59 <div class="refsect1" lang="en">
60 <a name="id2525933"></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>
65 };<br>
66 </p></div>
67 </div>
68 <div class="refsect1" lang="en">
69 <a name="id2525953"></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>
74 };<br>
75 </p></div>
76 </div>
77 <div class="refsect1" lang="en">
78 <a name="id2525998"></a><h2>SERVER</h2>
79 <div class="literallayout"><p><br>
80 server ( <em class="replaceable"><code>ipv4_address</code></em> | <em class="replaceable"><code>ipv6_address</code></em> ) {<br>
81         bogus <em class="replaceable"><code>boolean</code></em>;<br>
82         edns <em class="replaceable"><code>boolean</code></em>;<br>
83         provide-ixfr <em class="replaceable"><code>boolean</code></em>;<br>
84         request-ixfr <em class="replaceable"><code>boolean</code></em>;<br>
85         keys <em class="replaceable"><code>server_key</code></em>;<br>
86         transfers <em class="replaceable"><code>integer</code></em>;<br>
87         transfer-format ( many-answers | one-answer );<br>
88         transfer-source ( <em class="replaceable"><code>ipv4_address</code></em> | * )<br>
89                 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
90         transfer-source-v6 ( <em class="replaceable"><code>ipv6_address</code></em> | * )<br>
91                 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
92 <br>
93         support-ixfr <em class="replaceable"><code>boolean</code></em>; // obsolete<br>
94 };<br>
95 </p></div>
96 </div>
97 <div class="refsect1" lang="en">
98 <a name="id2526056"></a><h2>TRUSTED-KEYS</h2>
99 <div class="literallayout"><p><br>
100 trusted-keys {<br>
101         <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>
102 };<br>
103 </p></div>
104 </div>
105 <div class="refsect1" lang="en">
106 <a name="id2526082"></a><h2>CONTROLS</h2>
107 <div class="literallayout"><p><br>
108 controls {<br>
109         inet ( <em class="replaceable"><code>ipv4_address</code></em> | <em class="replaceable"><code>ipv6_address</code></em> | * )<br>
110                 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>]<br>
111                 allow { <em class="replaceable"><code>address_match_element</code></em>; ... }<br>
112                 [<span class="optional"> keys { <em class="replaceable"><code>string</code></em>; ... } </span>];<br>
113         unix <em class="replaceable"><code>unsupported</code></em>; // not implemented<br>
114 };<br>
115 </p></div>
116 </div>
117 <div class="refsect1" lang="en">
118 <a name="id2526117"></a><h2>LOGGING</h2>
119 <div class="literallayout"><p><br>
120 logging {<br>
121         channel <em class="replaceable"><code>string</code></em> {<br>
122                 file <em class="replaceable"><code>log_file</code></em>;<br>
123                 syslog <em class="replaceable"><code>optional_facility</code></em>;<br>
124                 null;<br>
125                 stderr;<br>
126                 severity <em class="replaceable"><code>log_severity</code></em>;<br>
127                 print-time <em class="replaceable"><code>boolean</code></em>;<br>
128                 print-severity <em class="replaceable"><code>boolean</code></em>;<br>
129                 print-category <em class="replaceable"><code>boolean</code></em>;<br>
130         };<br>
131         category <em class="replaceable"><code>string</code></em> { <em class="replaceable"><code>string</code></em>; ... };<br>
132 };<br>
133 </p></div>
134 </div>
135 <div class="refsect1" lang="en">
136 <a name="id2526155"></a><h2>LWRES</h2>
137 <div class="literallayout"><p><br>
138 lwres {<br>
139         listen-on [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>] {<br>
140                 ( <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>
141         };<br>
142         view <em class="replaceable"><code>string</code></em> <em class="replaceable"><code>optional_class</code></em>;<br>
143         search { <em class="replaceable"><code>string</code></em>; ... };<br>
144         ndots <em class="replaceable"><code>integer</code></em>;<br>
145 };<br>
146 </p></div>
147 </div>
148 <div class="refsect1" lang="en">
149 <a name="id2526197"></a><h2>OPTIONS</h2>
150 <div class="literallayout"><p><br>
151 options {<br>
152         avoid-v4-udp-ports { <em class="replaceable"><code>port</code></em>; ... };<br>
153         avoid-v6-udp-ports { <em class="replaceable"><code>port</code></em>; ... };<br>
154         blackhole { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
155         coresize <em class="replaceable"><code>size</code></em>;<br>
156         datasize <em class="replaceable"><code>size</code></em>;<br>
157         directory <em class="replaceable"><code>quoted_string</code></em>;<br>
158         dump-file <em class="replaceable"><code>quoted_string</code></em>;<br>
159         files <em class="replaceable"><code>size</code></em>;<br>
160         heartbeat-interval <em class="replaceable"><code>integer</code></em>;<br>
161         host-statistics <em class="replaceable"><code>boolean</code></em>; // not implemented<br>
162         host-statistics-max <em class="replaceable"><code>number</code></em>; // not implemented<br>
163         hostname ( <em class="replaceable"><code>quoted_string</code></em> | none );<br>
164         interface-interval <em class="replaceable"><code>integer</code></em>;<br>
165         listen-on [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>] { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
166         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>
167         match-mapped-addresses <em class="replaceable"><code>boolean</code></em>;<br>
168         memstatistics-file <em class="replaceable"><code>quoted_string</code></em>;<br>
169         pid-file ( <em class="replaceable"><code>quoted_string</code></em> | none );<br>
170         port <em class="replaceable"><code>integer</code></em>;<br>
171         querylog <em class="replaceable"><code>boolean</code></em>;<br>
172         recursing-file <em class="replaceable"><code>quoted_string</code></em>;<br>
173         random-device <em class="replaceable"><code>quoted_string</code></em>;<br>
174         recursive-clients <em class="replaceable"><code>integer</code></em>;<br>
175         serial-query-rate <em class="replaceable"><code>integer</code></em>;<br>
176         server-id ( <em class="replaceable"><code>quoted_string</code></em> | none |;<br>
177         stacksize <em class="replaceable"><code>size</code></em>;<br>
178         statistics-file <em class="replaceable"><code>quoted_string</code></em>;<br>
179         statistics-interval <em class="replaceable"><code>integer</code></em>; // not yet implemented<br>
180         tcp-clients <em class="replaceable"><code>integer</code></em>;<br>
181         tcp-listen-queue <em class="replaceable"><code>integer</code></em>;<br>
182         tkey-dhkey <em class="replaceable"><code>quoted_string</code></em> <em class="replaceable"><code>integer</code></em>;<br>
183         tkey-gssapi-credential <em class="replaceable"><code>quoted_string</code></em>;<br>
184         tkey-domain <em class="replaceable"><code>quoted_string</code></em>;<br>
185         transfers-per-ns <em class="replaceable"><code>integer</code></em>;<br>
186         transfers-in <em class="replaceable"><code>integer</code></em>;<br>
187         transfers-out <em class="replaceable"><code>integer</code></em>;<br>
188         use-ixfr <em class="replaceable"><code>boolean</code></em>;<br>
189         version ( <em class="replaceable"><code>quoted_string</code></em> | none );<br>
190         allow-recursion { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
191         sortlist { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
192         topology { <em class="replaceable"><code>address_match_element</code></em>; ... }; // not implemented<br>
193         auth-nxdomain <em class="replaceable"><code>boolean</code></em>; // default changed<br>
194         minimal-responses <em class="replaceable"><code>boolean</code></em>;<br>
195         recursion <em class="replaceable"><code>boolean</code></em>;<br>
196         rrset-order {<br>
197                 [<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>
198                 [<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>
199         };<br>
200         provide-ixfr <em class="replaceable"><code>boolean</code></em>;<br>
201         request-ixfr <em class="replaceable"><code>boolean</code></em>;<br>
202         rfc2308-type1 <em class="replaceable"><code>boolean</code></em>; // not yet implemented<br>
203         additional-from-auth <em class="replaceable"><code>boolean</code></em>;<br>
204         additional-from-cache <em class="replaceable"><code>boolean</code></em>;<br>
205         query-source <em class="replaceable"><code>querysource4</code></em>;<br>
206         query-source-v6 <em class="replaceable"><code>querysource6</code></em>;<br>
207         cleaning-interval <em class="replaceable"><code>integer</code></em>;<br>
208         min-roots <em class="replaceable"><code>integer</code></em>; // not implemented<br>
209         lame-ttl <em class="replaceable"><code>integer</code></em>;<br>
210         max-ncache-ttl <em class="replaceable"><code>integer</code></em>;<br>
211         max-cache-ttl <em class="replaceable"><code>integer</code></em>;<br>
212         transfer-format ( many-answers | one-answer );<br>
213         max-cache-size <em class="replaceable"><code>size_no_default</code></em>;<br>
214         check-names ( master | slave | response )<br>
215                 ( fail | warn | ignore );<br>
216         cache-file <em class="replaceable"><code>quoted_string</code></em>;<br>
217         suppress-initial-notify <em class="replaceable"><code>boolean</code></em>; // not yet implemented<br>
218         preferred-glue <em class="replaceable"><code>string</code></em>;<br>
219         dual-stack-servers [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>] {<br>
220                 ( <em class="replaceable"><code>quoted_string</code></em> [<span class="optional">port <em class="replaceable"><code>integer</code></em></span>] |<br>
221                 <em class="replaceable"><code>ipv4_address</code></em> [<span class="optional">port <em class="replaceable"><code>integer</code></em></span>] |<br>
222                 <em class="replaceable"><code>ipv6_address</code></em> [<span class="optional">port <em class="replaceable"><code>integer</code></em></span>] ); ...<br>
223         }<br>
224         edns-udp-size <em class="replaceable"><code>integer</code></em>;<br>
225         root-delegation-only [<span class="optional"> exclude { <em class="replaceable"><code>quoted_string</code></em>; ... } </span>];<br>
226         disable-algorithms <em class="replaceable"><code>string</code></em> { <em class="replaceable"><code>string</code></em>; ... };<br>
227         dnssec-enable <em class="replaceable"><code>boolean</code></em>;<br>
228         dnssec-lookaside <em class="replaceable"><code>string</code></em> trust-anchor <em class="replaceable"><code>string</code></em>;<br>
229         dnssec-must-be-secure <em class="replaceable"><code>string</code></em> <em class="replaceable"><code>boolean</code></em>;<br>
230 <br>
231         dialup <em class="replaceable"><code>dialuptype</code></em>;<br>
232         ixfr-from-differences <em class="replaceable"><code>ixfrdiff</code></em>;<br>
233 <br>
234         allow-query { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
235         allow-transfer { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
236         allow-update-forwarding { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
237 <br>
238         notify <em class="replaceable"><code>notifytype</code></em>;<br>
239         notify-source ( <em class="replaceable"><code>ipv4_address</code></em> | * ) [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
240         notify-source-v6 ( <em class="replaceable"><code>ipv6_address</code></em> | * ) [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
241         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>
242                 [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>]; ... };<br>
243         allow-notify { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
244 <br>
245         forward ( first | only );<br>
246         forwarders [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>] {<br>
247                 ( <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>
248         };<br>
249 <br>
250         max-journal-size <em class="replaceable"><code>size_no_default</code></em>;<br>
251         max-transfer-time-in <em class="replaceable"><code>integer</code></em>;<br>
252         max-transfer-time-out <em class="replaceable"><code>integer</code></em>;<br>
253         max-transfer-idle-in <em class="replaceable"><code>integer</code></em>;<br>
254         max-transfer-idle-out <em class="replaceable"><code>integer</code></em>;<br>
255         max-retry-time <em class="replaceable"><code>integer</code></em>;<br>
256         min-retry-time <em class="replaceable"><code>integer</code></em>;<br>
257         max-refresh-time <em class="replaceable"><code>integer</code></em>;<br>
258         min-refresh-time <em class="replaceable"><code>integer</code></em>;<br>
259         multi-master <em class="replaceable"><code>boolean</code></em>;<br>
260         sig-validity-interval <em class="replaceable"><code>integer</code></em>;<br>
261 <br>
262         transfer-source ( <em class="replaceable"><code>ipv4_address</code></em> | * )<br>
263                 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
264         transfer-source-v6 ( <em class="replaceable"><code>ipv6_address</code></em> | * )<br>
265                 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
266 <br>
267         alt-transfer-source ( <em class="replaceable"><code>ipv4_address</code></em> | * )<br>
268                 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
269         alt-transfer-source-v6 ( <em class="replaceable"><code>ipv6_address</code></em> | * )<br>
270                 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
271         use-alt-transfer-source <em class="replaceable"><code>boolean</code></em>;<br>
272 <br>
273         zone-statistics <em class="replaceable"><code>boolean</code></em>;<br>
274         key-directory <em class="replaceable"><code>quoted_string</code></em>;<br>
275 <br>
276         allow-v6-synthesis { <em class="replaceable"><code>address_match_element</code></em>; ... }; // obsolete<br>
277         deallocate-on-exit <em class="replaceable"><code>boolean</code></em>; // obsolete<br>
278         fake-iquery <em class="replaceable"><code>boolean</code></em>; // obsolete<br>
279         fetch-glue <em class="replaceable"><code>boolean</code></em>; // obsolete<br>
280         has-old-clients <em class="replaceable"><code>boolean</code></em>; // obsolete<br>
281         maintain-ixfr-base <em class="replaceable"><code>boolean</code></em>; // obsolete<br>
282         max-ixfr-log-size <em class="replaceable"><code>size</code></em>; // obsolete<br>
283         multiple-cnames <em class="replaceable"><code>boolean</code></em>; // obsolete<br>
284         named-xfer <em class="replaceable"><code>quoted_string</code></em>; // obsolete<br>
285         serial-queries <em class="replaceable"><code>integer</code></em>; // obsolete<br>
286         treat-cr-as-space <em class="replaceable"><code>boolean</code></em>; // obsolete<br>
287         use-id-pool <em class="replaceable"><code>boolean</code></em>; // obsolete<br>
288 };<br>
289 </p></div>
290 </div>
291 <div class="refsect1" lang="en">
292 <a name="id2526858"></a><h2>VIEW</h2>
293 <div class="literallayout"><p><br>
294 view <em class="replaceable"><code>string</code></em> <em class="replaceable"><code>optional_class</code></em> {<br>
295         match-clients { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
296         match-destinations { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
297         match-recursive-only <em class="replaceable"><code>boolean</code></em>;<br>
298 <br>
299         key <em class="replaceable"><code>string</code></em> {<br>
300                 algorithm <em class="replaceable"><code>string</code></em>;<br>
301                 secret <em class="replaceable"><code>string</code></em>;<br>
302         };<br>
303 <br>
304         zone <em class="replaceable"><code>string</code></em> <em class="replaceable"><code>optional_class</code></em> {<br>
305                 ...<br>
306         };<br>
307 <br>
308         server ( <em class="replaceable"><code>ipv4_address</code></em> | <em class="replaceable"><code>ipv6_address</code></em> ) {<br>
309                 ...<br>
310         };<br>
311 <br>
312         trusted-keys {<br>
313                 <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>
314         };<br>
315 <br>
316         allow-recursion { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
317         sortlist { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
318         topology { <em class="replaceable"><code>address_match_element</code></em>; ... }; // not implemented<br>
319         auth-nxdomain <em class="replaceable"><code>boolean</code></em>; // default changed<br>
320         minimal-responses <em class="replaceable"><code>boolean</code></em>;<br>
321         recursion <em class="replaceable"><code>boolean</code></em>;<br>
322         rrset-order {<br>
323                 [<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>
324                 [<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>
325         };<br>
326         provide-ixfr <em class="replaceable"><code>boolean</code></em>;<br>
327         request-ixfr <em class="replaceable"><code>boolean</code></em>;<br>
328         rfc2308-type1 <em class="replaceable"><code>boolean</code></em>; // not yet implemented<br>
329         additional-from-auth <em class="replaceable"><code>boolean</code></em>;<br>
330         additional-from-cache <em class="replaceable"><code>boolean</code></em>;<br>
331         query-source <em class="replaceable"><code>querysource4</code></em>;<br>
332         query-source-v6 <em class="replaceable"><code>querysource6</code></em>;<br>
333         cleaning-interval <em class="replaceable"><code>integer</code></em>;<br>
334         min-roots <em class="replaceable"><code>integer</code></em>; // not implemented<br>
335         lame-ttl <em class="replaceable"><code>integer</code></em>;<br>
336         max-ncache-ttl <em class="replaceable"><code>integer</code></em>;<br>
337         max-cache-ttl <em class="replaceable"><code>integer</code></em>;<br>
338         transfer-format ( many-answers | one-answer );<br>
339         max-cache-size <em class="replaceable"><code>size_no_default</code></em>;<br>
340         check-names ( master | slave | response )<br>
341                 ( fail | warn | ignore );<br>
342         cache-file <em class="replaceable"><code>quoted_string</code></em>;<br>
343         suppress-initial-notify <em class="replaceable"><code>boolean</code></em>; // not yet implemented<br>
344         preferred-glue <em class="replaceable"><code>string</code></em>;<br>
345         dual-stack-servers [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>] {<br>
346                 ( <em class="replaceable"><code>quoted_string</code></em> [<span class="optional">port <em class="replaceable"><code>integer</code></em></span>] |<br>
347                 <em class="replaceable"><code>ipv4_address</code></em> [<span class="optional">port <em class="replaceable"><code>integer</code></em></span>] |<br>
348                 <em class="replaceable"><code>ipv6_address</code></em> [<span class="optional">port <em class="replaceable"><code>integer</code></em></span>] ); ...<br>
349         };<br>
350         edns-udp-size <em class="replaceable"><code>integer</code></em>;<br>
351         root-delegation-only [<span class="optional"> exclude { <em class="replaceable"><code>quoted_string</code></em>; ... } </span>];<br>
352         disable-algorithms <em class="replaceable"><code>string</code></em> { <em class="replaceable"><code>string</code></em>; ... };<br>
353         dnssec-enable <em class="replaceable"><code>boolean</code></em>;<br>
354         dnssec-lookaside <em class="replaceable"><code>string</code></em> trust-anchor <em class="replaceable"><code>string</code></em>;<br>
355 <br>
356         dnssec-must-be-secure <em class="replaceable"><code>string</code></em> <em class="replaceable"><code>boolean</code></em>;<br>
357         dialup <em class="replaceable"><code>dialuptype</code></em>;<br>
358         ixfr-from-differences <em class="replaceable"><code>ixfrdiff</code></em>;<br>
359 <br>
360         allow-query { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
361         allow-transfer { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
362         allow-update-forwarding { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
363 <br>
364         notify <em class="replaceable"><code>notifytype</code></em>;<br>
365         notify-source ( <em class="replaceable"><code>ipv4_address</code></em> | * ) [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
366         notify-source-v6 ( <em class="replaceable"><code>ipv6_address</code></em> | * ) [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
367         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>
368                 [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>]; ... };<br>
369         allow-notify { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
370 <br>
371         forward ( first | only );<br>
372         forwarders [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>] {<br>
373                 ( <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>
374         };<br>
375 <br>
376         max-journal-size <em class="replaceable"><code>size_no_default</code></em>;<br>
377         max-transfer-time-in <em class="replaceable"><code>integer</code></em>;<br>
378         max-transfer-time-out <em class="replaceable"><code>integer</code></em>;<br>
379         max-transfer-idle-in <em class="replaceable"><code>integer</code></em>;<br>
380         max-transfer-idle-out <em class="replaceable"><code>integer</code></em>;<br>
381         max-retry-time <em class="replaceable"><code>integer</code></em>;<br>
382         min-retry-time <em class="replaceable"><code>integer</code></em>;<br>
383         max-refresh-time <em class="replaceable"><code>integer</code></em>;<br>
384         min-refresh-time <em class="replaceable"><code>integer</code></em>;<br>
385         multi-master <em class="replaceable"><code>boolean</code></em>;<br>
386         sig-validity-interval <em class="replaceable"><code>integer</code></em>;<br>
387 <br>
388         transfer-source ( <em class="replaceable"><code>ipv4_address</code></em> | * )<br>
389                 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
390         transfer-source-v6 ( <em class="replaceable"><code>ipv6_address</code></em> | * )<br>
391                 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
392 <br>
393         alt-transfer-source ( <em class="replaceable"><code>ipv4_address</code></em> | * )<br>
394                 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
395         alt-transfer-source-v6 ( <em class="replaceable"><code>ipv6_address</code></em> | * )<br>
396                 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
397         use-alt-transfer-source <em class="replaceable"><code>boolean</code></em>;<br>
398 <br>
399         zone-statistics <em class="replaceable"><code>boolean</code></em>;<br>
400         key-directory <em class="replaceable"><code>quoted_string</code></em>;<br>
401 <br>
402         allow-v6-synthesis { <em class="replaceable"><code>address_match_element</code></em>; ... }; // obsolete<br>
403         fetch-glue <em class="replaceable"><code>boolean</code></em>; // obsolete<br>
404         maintain-ixfr-base <em class="replaceable"><code>boolean</code></em>; // obsolete<br>
405         max-ixfr-log-size <em class="replaceable"><code>size</code></em>; // obsolete<br>
406 };<br>
407 </p></div>
408 </div>
409 <div class="refsect1" lang="en">
410 <a name="id2527269"></a><h2>ZONE</h2>
411 <div class="literallayout"><p><br>
412 zone <em class="replaceable"><code>string</code></em> <em class="replaceable"><code>optional_class</code></em> {<br>
413         type ( master | slave | stub | hint |<br>
414                 forward | delegation-only );<br>
415         file <em class="replaceable"><code>quoted_string</code></em>;<br>
416 <br>
417         masters [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>] {<br>
418                 ( <em class="replaceable"><code>masters</code></em> |<br>
419                 <em class="replaceable"><code>ipv4_address</code></em> [<span class="optional">port <em class="replaceable"><code>integer</code></em></span>] |<br>
420                 <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>
421         };<br>
422 <br>
423         database <em class="replaceable"><code>string</code></em>;<br>
424         delegation-only <em class="replaceable"><code>boolean</code></em>;<br>
425         check-names ( fail | warn | ignore );<br>
426         dialup <em class="replaceable"><code>dialuptype</code></em>;<br>
427         ixfr-from-differences <em class="replaceable"><code>boolean</code></em>;<br>
428 <br>
429         allow-query { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
430         allow-transfer { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
431         allow-update { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
432         allow-update-forwarding { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
433         update-policy {<br>
434                 ( grant | deny ) <em class="replaceable"><code>string</code></em><br>
435                 ( name | subdomain | wildcard | self ) <em class="replaceable"><code>string</code></em><br>
436                 <em class="replaceable"><code>rrtypelist</code></em>; ...<br>
437         };<br>
438 <br>
439         notify <em class="replaceable"><code>notifytype</code></em>;<br>
440         notify-source ( <em class="replaceable"><code>ipv4_address</code></em> | * ) [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
441         notify-source-v6 ( <em class="replaceable"><code>ipv6_address</code></em> | * ) [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
442         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>
443                 [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>]; ... };<br>
444         allow-notify { <em class="replaceable"><code>address_match_element</code></em>; ... };<br>
445 <br>
446         forward ( first | only );<br>
447         forwarders [<span class="optional"> port <em class="replaceable"><code>integer</code></em> </span>] {<br>
448                 ( <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>
449         };<br>
450 <br>
451         max-journal-size <em class="replaceable"><code>size_no_default</code></em>;<br>
452         max-transfer-time-in <em class="replaceable"><code>integer</code></em>;<br>
453         max-transfer-time-out <em class="replaceable"><code>integer</code></em>;<br>
454         max-transfer-idle-in <em class="replaceable"><code>integer</code></em>;<br>
455         max-transfer-idle-out <em class="replaceable"><code>integer</code></em>;<br>
456         max-retry-time <em class="replaceable"><code>integer</code></em>;<br>
457         min-retry-time <em class="replaceable"><code>integer</code></em>;<br>
458         max-refresh-time <em class="replaceable"><code>integer</code></em>;<br>
459         min-refresh-time <em class="replaceable"><code>integer</code></em>;<br>
460         multi-master <em class="replaceable"><code>boolean</code></em>;<br>
461         sig-validity-interval <em class="replaceable"><code>integer</code></em>;<br>
462 <br>
463         transfer-source ( <em class="replaceable"><code>ipv4_address</code></em> | * )<br>
464                 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
465         transfer-source-v6 ( <em class="replaceable"><code>ipv6_address</code></em> | * )<br>
466                 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
467 <br>
468         alt-transfer-source ( <em class="replaceable"><code>ipv4_address</code></em> | * )<br>
469                 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
470         alt-transfer-source-v6 ( <em class="replaceable"><code>ipv6_address</code></em> | * )<br>
471                 [<span class="optional"> port ( <em class="replaceable"><code>integer</code></em> | * ) </span>];<br>
472         use-alt-transfer-source <em class="replaceable"><code>boolean</code></em>;<br>
473 <br>
474         zone-statistics <em class="replaceable"><code>boolean</code></em>;<br>
475         key-directory <em class="replaceable"><code>quoted_string</code></em>;<br>
476 <br>
477         ixfr-base <em class="replaceable"><code>quoted_string</code></em>; // obsolete<br>
478         ixfr-tmp-file <em class="replaceable"><code>quoted_string</code></em>; // obsolete<br>
479         maintain-ixfr-base <em class="replaceable"><code>boolean</code></em>; // obsolete<br>
480         max-ixfr-log-size <em class="replaceable"><code>size</code></em>; // obsolete<br>
481         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>
482 };<br>
483 </p></div>
484 </div>
485 <div class="refsect1" lang="en">
486 <a name="id2527606"></a><h2>FILES</h2>
487 <p>
488 <code class="filename">/etc/named.conf</code>
489 </p>
490 </div>
491 <div class="refsect1" lang="en">
492 <a name="id2527619"></a><h2>SEE ALSO</h2>
493 <p>
494 <span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>,
495 <span class="citerefentry"><span class="refentrytitle">rndc</span>(8)</span>,
496 <span class="citerefentry"><span class="refentrytitle">BIND 9 Adminstrators Reference Manual</span></span>.
497 </p>
498 </div>
499 </div></body>
500 </html>