← Back to branch summary

~andreserl/ubuntu/lucid/bind9/bind9-apport-533601

« back to all changes in this revision

Viewing changes to bin/named/named.conf.5

  • Committer: Bazaar Package Importer
  • Author(s): LaMont Jones
  • Date: 2006-01-05 12:29:28 UTC
  • mfrom: (1.1.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20060105122928-oih7ttkkmpb90q8q
Tags: 1:9.3.2-1
* New upstream
* use lsb-base for start/stop messages in init.d.
* switch to debhelper 4

Show diffs side-by-side

added added

removed removed

Lines of Context:
bin/named/named.conf.5
1
 
.\" Copyright (C) 2004  Internet Systems Consortium, Inc. ("ISC")
2
 
.\"
 
1
.\" Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC")
 
2
.\" 
3
3
.\" Permission to use, copy, modify, and distribute this software for any
4
4
.\" purpose with or without fee is hereby granted, provided that the above
5
5
.\" copyright notice and this permission notice appear in all copies.
6
 
.\"
 
6
.\" 
7
7
.\" THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
8
8
.\" REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
9
 
.\" AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
 
9
.\" AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
10
10
.\" INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
11
11
.\" LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
12
12
.\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
13
13
.\" PERFORMANCE OF THIS SOFTWARE.
14
14
.\"
15
 
.\" $Id: named.conf.5,v 1.1.4.3 2004/10/18 02:33:06 marka Exp $
 
15
.\" $Id: named.conf.5,v 1.1.4.6 2005/10/13 02:33:47 marka Exp $
16
16
.\"
17
 
.TH "NAMED.CONF" "5" "Aug 13, 2004" "BIND9" ""
18
 
.SH NAME
 
17
.hy 0
 
18
.ad l
 
19
.\" ** You probably do not want to edit this file directly **
 
20
.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
 
21
.\" Instead of manually editing it, you probably should edit the DocBook XML
 
22
.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
 
23
.TH "\\FINAMED.CONF\\FR" "5" "Aug 13, 2004" "BIND9" "BIND9"
 
24
.\" disable hyphenation
 
25
.nh
 
26
.\" disable justification (adjust text to left margin only)
 
27
.ad l
 
28
.SH "NAME"
19
29
named.conf \- configuration file for named
20
 
.SH SYNOPSIS
21
 
.sp
 
30
.SH "SYNOPSIS"
 
31
.HP 11
22
32
\fBnamed.conf\fR
23
33
.SH "DESCRIPTION"
24
34
.PP
25
 
\fInamed.conf\fR is the configuration file for
26
 
\fBnamed\fR. Statements are enclosed
27
 
in braces and terminated with a semi-colon. Clauses in
28
 
the statements are also semi-colon terminated. The usual
29
 
comment styles are supported:
 
35
\fInamed.conf\fR
 
36
is the configuration file for
 
37
\fBnamed\fR. Statements are enclosed in braces and terminated with a semi\-colon. Clauses in the statements are also semi\-colon terminated. The usual comment styles are supported:
30
38
.PP
31
39
C style: /* */
32
40
.PP
37
45
.sp
38
46
.nf
39
47
acl \fIstring\fR { \fIaddress_match_element\fR; ... };
40
 
.sp
41
48
.fi
42
49
.SH "KEY"
43
50
.sp
46
53
        algorithm \fIstring\fR;
47
54
        secret \fIstring\fR;
48
55
};
49
 
.sp
50
56
.fi
51
57
.SH "MASTERS"
52
58
.sp
55
61
        ( \fImasters\fR | \fIipv4_address\fR [port \fIinteger\fR] |
56
62
        \fIipv6_address\fR [port \fIinteger\fR] ) [ key \fIstring\fR ]; ...
57
63
};
58
 
.sp
59
64
.fi
60
65
.SH "SERVER"
61
66
.sp
63
68
server ( \fIipv4_address\fR | \fIipv6_address\fR ) {
64
69
        bogus \fIboolean\fR;
65
70
        edns \fIboolean\fR;
66
 
        provide-ixfr \fIboolean\fR;
67
 
        request-ixfr \fIboolean\fR;
 
71
        provide\-ixfr \fIboolean\fR;
 
72
        request\-ixfr \fIboolean\fR;
68
73
        keys \fIserver_key\fR;
69
74
        transfers \fIinteger\fR;
70
 
        transfer-format ( many-answers | one-answer );
71
 
        transfer-source ( \fIipv4_address\fR | * )
72
 
                [ port ( \fIinteger\fR | * ) ];
73
 
        transfer-source-v6 ( \fIipv6_address\fR | * )
74
 
                [ port ( \fIinteger\fR | * ) ];
75
 
 
76
 
        support-ixfr \fIboolean\fR; // obsolete
 
75
        transfer\-format ( many\-answers | one\-answer );
 
76
        transfer\-source ( \fIipv4_address\fR | * )
 
77
                [ port ( \fIinteger\fR | * ) ];
 
78
        transfer\-source\-v6 ( \fIipv6_address\fR | * )
 
79
                [ port ( \fIinteger\fR | * ) ];
 
80
        support\-ixfr \fIboolean\fR; // obsolete
77
81
};
78
 
.sp
79
82
.fi
80
 
.SH "TRUSTED-KEYS"
 
83
.SH "TRUSTED\-KEYS"
81
84
.sp
82
85
.nf
83
 
trusted-keys {
 
86
trusted\-keys {
84
87
        \fIdomain_name\fR \fIflags\fR \fIprotocol\fR \fIalgorithm\fR \fIkey\fR; ... 
85
88
};
86
 
.sp
87
89
.fi
88
90
.SH "CONTROLS"
89
91
.sp
95
97
                [ keys { \fIstring\fR; ... } ];
96
98
        unix \fIunsupported\fR; // not implemented
97
99
};
98
 
.sp
99
100
.fi
100
101
.SH "LOGGING"
101
102
.sp
107
108
                null;
108
109
                stderr;
109
110
                severity \fIlog_severity\fR;
110
 
                print-time \fIboolean\fR;
111
 
                print-severity \fIboolean\fR;
112
 
                print-category \fIboolean\fR;
 
111
                print\-time \fIboolean\fR;
 
112
                print\-severity \fIboolean\fR;
 
113
                print\-category \fIboolean\fR;
113
114
        };
114
115
        category \fIstring\fR { \fIstring\fR; ... };
115
116
};
116
 
.sp
117
117
.fi
118
118
.SH "LWRES"
119
119
.sp
120
120
.nf
121
121
lwres {
122
 
        listen-on [ port \fIinteger\fR ] {
 
122
        listen\-on [ port \fIinteger\fR ] {
123
123
                ( \fIipv4_address\fR | \fIipv6_address\fR ) [ port \fIinteger\fR ]; ...
124
124
        };
125
125
        view \fIstring\fR \fIoptional_class\fR;
126
126
        search { \fIstring\fR; ... };
127
127
        ndots \fIinteger\fR;
128
128
};
129
 
.sp
130
129
.fi
131
130
.SH "OPTIONS"
132
131
.sp
133
132
.nf
134
133
options {
135
 
        avoid-v4-udp-ports { \fIport\fR; ... };
136
 
        avoid-v6-udp-ports { \fIport\fR; ... };
 
134
        avoid\-v4\-udp\-ports { \fIport\fR; ... };
 
135
        avoid\-v6\-udp\-ports { \fIport\fR; ... };
137
136
        blackhole { \fIaddress_match_element\fR; ... };
138
137
        coresize \fIsize\fR;
139
138
        datasize \fIsize\fR;
140
139
        directory \fIquoted_string\fR;
141
 
        dump-file \fIquoted_string\fR;
 
140
        dump\-file \fIquoted_string\fR;
142
141
        files \fIsize\fR;
143
 
        heartbeat-interval \fIinteger\fR;
144
 
        host-statistics \fIboolean\fR; // not implemented
145
 
        host-statistics-max \fInumber\fR; // not implemented
 
142
        heartbeat\-interval \fIinteger\fR;
 
143
        host\-statistics \fIboolean\fR; // not implemented
 
144
        host\-statistics\-max \fInumber\fR; // not implemented
146
145
        hostname ( \fIquoted_string\fR | none );
147
 
        interface-interval \fIinteger\fR;
148
 
        listen-on [ port \fIinteger\fR ] { \fIaddress_match_element\fR; ... };
149
 
        listen-on-v6 [ port \fIinteger\fR ] { \fIaddress_match_element\fR; ... };
150
 
        match-mapped-addresses \fIboolean\fR;
151
 
        memstatistics-file \fIquoted_string\fR;
152
 
        pid-file ( \fIquoted_string\fR | none );
 
146
        interface\-interval \fIinteger\fR;
 
147
        listen\-on [ port \fIinteger\fR ] { \fIaddress_match_element\fR; ... };
 
148
        listen\-on\-v6 [ port \fIinteger\fR ] { \fIaddress_match_element\fR; ... };
 
149
        match\-mapped\-addresses \fIboolean\fR;
 
150
        memstatistics\-file \fIquoted_string\fR;
 
151
        pid\-file ( \fIquoted_string\fR | none );
153
152
        port \fIinteger\fR;
154
153
        querylog \fIboolean\fR;
155
 
        recursing-file \fIquoted_string\fR;
156
 
        random-device \fIquoted_string\fR;
157
 
        recursive-clients \fIinteger\fR;
158
 
        serial-query-rate \fIinteger\fR;
159
 
        server-id ( \fIquoted_string\fR | none |;
 
154
        recursing\-file \fIquoted_string\fR;
 
155
        random\-device \fIquoted_string\fR;
 
156
        recursive\-clients \fIinteger\fR;
 
157
        serial\-query\-rate \fIinteger\fR;
 
158
        server\-id ( \fIquoted_string\fR | none |;
160
159
        stacksize \fIsize\fR;
161
 
        statistics-file \fIquoted_string\fR;
162
 
        statistics-interval \fIinteger\fR; // not yet implemented
163
 
        tcp-clients \fIinteger\fR;
164
 
        tcp-listen-queue \fIinteger\fR;
165
 
        tkey-dhkey \fIquoted_string\fR \fIinteger\fR;
166
 
        tkey-gssapi-credential \fIquoted_string\fR;
167
 
        tkey-domain \fIquoted_string\fR;
168
 
        transfers-per-ns \fIinteger\fR;
169
 
        transfers-in \fIinteger\fR;
170
 
        transfers-out \fIinteger\fR;
171
 
        use-ixfr \fIboolean\fR;
 
160
        statistics\-file \fIquoted_string\fR;
 
161
        statistics\-interval \fIinteger\fR; // not yet implemented
 
162
        tcp\-clients \fIinteger\fR;
 
163
        tcp\-listen\-queue \fIinteger\fR;
 
164
        tkey\-dhkey \fIquoted_string\fR \fIinteger\fR;
 
165
        tkey\-gssapi\-credential \fIquoted_string\fR;
 
166
        tkey\-domain \fIquoted_string\fR;
 
167
        transfers\-per\-ns \fIinteger\fR;
 
168
        transfers\-in \fIinteger\fR;
 
169
        transfers\-out \fIinteger\fR;
 
170
        use\-ixfr \fIboolean\fR;
172
171
        version ( \fIquoted_string\fR | none );
173
 
        allow-recursion { \fIaddress_match_element\fR; ... };
 
172
        allow\-recursion { \fIaddress_match_element\fR; ... };
174
173
        sortlist { \fIaddress_match_element\fR; ... };
175
174
        topology { \fIaddress_match_element\fR; ... }; // not implemented
176
 
        auth-nxdomain \fIboolean\fR; // default changed
177
 
        minimal-responses \fIboolean\fR;
 
175
        auth\-nxdomain \fIboolean\fR; // default changed
 
176
        minimal\-responses \fIboolean\fR;
178
177
        recursion \fIboolean\fR;
179
 
        rrset-order {
 
178
        rrset\-order {
180
179
                [ class \fIstring\fR ] [ type \fIstring\fR ]
181
180
                [ name \fIquoted_string\fR ] \fIstring\fR \fIstring\fR; ...
182
181
        };
183
 
        provide-ixfr \fIboolean\fR;
184
 
        request-ixfr \fIboolean\fR;
185
 
        rfc2308-type1 \fIboolean\fR; // not yet implemented
186
 
        additional-from-auth \fIboolean\fR;
187
 
        additional-from-cache \fIboolean\fR;
188
 
        query-source \fIquerysource4\fR;
189
 
        query-source-v6 \fIquerysource6\fR;
190
 
        cleaning-interval \fIinteger\fR;
191
 
        min-roots \fIinteger\fR; // not implemented
192
 
        lame-ttl \fIinteger\fR;
193
 
        max-ncache-ttl \fIinteger\fR;
194
 
        max-cache-ttl \fIinteger\fR;
195
 
        transfer-format ( many-answers | one-answer );
196
 
        max-cache-size \fIsize_no_default\fR;
197
 
        check-names ( master | slave | response )
 
182
        provide\-ixfr \fIboolean\fR;
 
183
        request\-ixfr \fIboolean\fR;
 
184
        rfc2308\-type1 \fIboolean\fR; // not yet implemented
 
185
        additional\-from\-auth \fIboolean\fR;
 
186
        additional\-from\-cache \fIboolean\fR;
 
187
        query\-source \fIquerysource4\fR;
 
188
        query\-source\-v6 \fIquerysource6\fR;
 
189
        cleaning\-interval \fIinteger\fR;
 
190
        min\-roots \fIinteger\fR; // not implemented
 
191
        lame\-ttl \fIinteger\fR;
 
192
        max\-ncache\-ttl \fIinteger\fR;
 
193
        max\-cache\-ttl \fIinteger\fR;
 
194
        transfer\-format ( many\-answers | one\-answer );
 
195
        max\-cache\-size \fIsize_no_default\fR;
 
196
        check\-names ( master | slave | response )
198
197
                ( fail | warn | ignore );
199
 
        cache-file \fIquoted_string\fR;
200
 
        suppress-initial-notify \fIboolean\fR; // not yet implemented
201
 
        preferred-glue \fIstring\fR;
202
 
        dual-stack-servers [ port \fIinteger\fR ] {
 
198
        cache\-file \fIquoted_string\fR;
 
199
        suppress\-initial\-notify \fIboolean\fR; // not yet implemented
 
200
        preferred\-glue \fIstring\fR;
 
201
        dual\-stack\-servers [ port \fIinteger\fR ] {
203
202
                ( \fIquoted_string\fR [port \fIinteger\fR] |
204
203
                \fIipv4_address\fR [port \fIinteger\fR] |
205
204
                \fIipv6_address\fR [port \fIinteger\fR] ); ...
206
205
        }
207
 
        edns-udp-size \fIinteger\fR;
208
 
        root-delegation-only [ exclude { \fIquoted_string\fR; ... } ];
209
 
        disable-algorithms \fIstring\fR { \fIstring\fR; ... };
210
 
        dnssec-enable \fIboolean\fR;
211
 
        dnssec-lookaside \fIstring\fR trust-anchor \fIstring\fR;
212
 
        dnssec-must-be-secure \fIstring\fR \fIboolean\fR;
213
 
 
 
206
        edns\-udp\-size \fIinteger\fR;
 
207
        root\-delegation\-only [ exclude { \fIquoted_string\fR; ... } ];
 
208
        disable\-algorithms \fIstring\fR { \fIstring\fR; ... };
 
209
        dnssec\-enable \fIboolean\fR;
 
210
        dnssec\-lookaside \fIstring\fR trust\-anchor \fIstring\fR;
 
211
        dnssec\-must\-be\-secure \fIstring\fR \fIboolean\fR;
214
212
        dialup \fIdialuptype\fR;
215
 
        ixfr-from-differences \fIixfrdiff\fR;
216
 
 
217
 
        allow-query { \fIaddress_match_element\fR; ... };
218
 
        allow-transfer { \fIaddress_match_element\fR; ... };
219
 
        allow-update-forwarding { \fIaddress_match_element\fR; ... };
220
 
 
 
213
        ixfr\-from\-differences \fIixfrdiff\fR;
 
214
        allow\-query { \fIaddress_match_element\fR; ... };
 
215
        allow\-transfer { \fIaddress_match_element\fR; ... };
 
216
        allow\-update\-forwarding { \fIaddress_match_element\fR; ... };
221
217
        notify \fInotifytype\fR;
222
 
        notify-source ( \fIipv4_address\fR | * ) [ port ( \fIinteger\fR | * ) ];
223
 
        notify-source-v6 ( \fIipv6_address\fR | * ) [ port ( \fIinteger\fR | * ) ];
224
 
        also-notify [ port \fIinteger\fR ] { ( \fIipv4_address\fR | \fIipv6_address\fR )
 
218
        notify\-source ( \fIipv4_address\fR | * ) [ port ( \fIinteger\fR | * ) ];
 
219
        notify\-source\-v6 ( \fIipv6_address\fR | * ) [ port ( \fIinteger\fR | * ) ];
 
220
        also\-notify [ port \fIinteger\fR ] { ( \fIipv4_address\fR | \fIipv6_address\fR )
225
221
                [ port \fIinteger\fR ]; ... };
226
 
        allow-notify { \fIaddress_match_element\fR; ... };
227
 
 
 
222
        allow\-notify { \fIaddress_match_element\fR; ... };
228
223
        forward ( first | only );
229
224
        forwarders [ port \fIinteger\fR ] {
230
225
                ( \fIipv4_address\fR | \fIipv6_address\fR ) [ port \fIinteger\fR ]; ...
231
226
        };
232
 
 
233
 
        max-journal-size \fIsize_no_default\fR;
234
 
        max-transfer-time-in \fIinteger\fR;
235
 
        max-transfer-time-out \fIinteger\fR;
236
 
        max-transfer-idle-in \fIinteger\fR;
237
 
        max-transfer-idle-out \fIinteger\fR;
238
 
        max-retry-time \fIinteger\fR;
239
 
        min-retry-time \fIinteger\fR;
240
 
        max-refresh-time \fIinteger\fR;
241
 
        min-refresh-time \fIinteger\fR;
242
 
        multi-master \fIboolean\fR;
243
 
        sig-validity-interval \fIinteger\fR;
244
 
 
245
 
        transfer-source ( \fIipv4_address\fR | * )
246
 
                [ port ( \fIinteger\fR | * ) ];
247
 
        transfer-source-v6 ( \fIipv6_address\fR | * )
248
 
                [ port ( \fIinteger\fR | * ) ];
249
 
 
250
 
        alt-transfer-source ( \fIipv4_address\fR | * )
251
 
                [ port ( \fIinteger\fR | * ) ];
252
 
        alt-transfer-source-v6 ( \fIipv6_address\fR | * )
253
 
                [ port ( \fIinteger\fR | * ) ];
254
 
        use-alt-transfer-source \fIboolean\fR;
255
 
 
256
 
        zone-statistics \fIboolean\fR;
257
 
        key-directory \fIquoted_string\fR;
258
 
 
259
 
        allow-v6-synthesis { \fIaddress_match_element\fR; ... }; // obsolete
260
 
        deallocate-on-exit \fIboolean\fR; // obsolete
261
 
        fake-iquery \fIboolean\fR; // obsolete
262
 
        fetch-glue \fIboolean\fR; // obsolete
263
 
        has-old-clients \fIboolean\fR; // obsolete
264
 
        maintain-ixfr-base \fIboolean\fR; // obsolete
265
 
        max-ixfr-log-size \fIsize\fR; // obsolete
266
 
        multiple-cnames \fIboolean\fR; // obsolete
267
 
        named-xfer \fIquoted_string\fR; // obsolete
268
 
        serial-queries \fIinteger\fR; // obsolete
269
 
        treat-cr-as-space \fIboolean\fR; // obsolete
270
 
        use-id-pool \fIboolean\fR; // obsolete
 
227
        max\-journal\-size \fIsize_no_default\fR;
 
228
        max\-transfer\-time\-in \fIinteger\fR;
 
229
        max\-transfer\-time\-out \fIinteger\fR;
 
230
        max\-transfer\-idle\-in \fIinteger\fR;
 
231
        max\-transfer\-idle\-out \fIinteger\fR;
 
232
        max\-retry\-time \fIinteger\fR;
 
233
        min\-retry\-time \fIinteger\fR;
 
234
        max\-refresh\-time \fIinteger\fR;
 
235
        min\-refresh\-time \fIinteger\fR;
 
236
        multi\-master \fIboolean\fR;
 
237
        sig\-validity\-interval \fIinteger\fR;
 
238
        transfer\-source ( \fIipv4_address\fR | * )
 
239
                [ port ( \fIinteger\fR | * ) ];
 
240
        transfer\-source\-v6 ( \fIipv6_address\fR | * )
 
241
                [ port ( \fIinteger\fR | * ) ];
 
242
        alt\-transfer\-source ( \fIipv4_address\fR | * )
 
243
                [ port ( \fIinteger\fR | * ) ];
 
244
        alt\-transfer\-source\-v6 ( \fIipv6_address\fR | * )
 
245
                [ port ( \fIinteger\fR | * ) ];
 
246
        use\-alt\-transfer\-source \fIboolean\fR;
 
247
        zone\-statistics \fIboolean\fR;
 
248
        key\-directory \fIquoted_string\fR;
 
249
        allow\-v6\-synthesis { \fIaddress_match_element\fR; ... }; // obsolete
 
250
        deallocate\-on\-exit \fIboolean\fR; // obsolete
 
251
        fake\-iquery \fIboolean\fR; // obsolete
 
252
        fetch\-glue \fIboolean\fR; // obsolete
 
253
        has\-old\-clients \fIboolean\fR; // obsolete
 
254
        maintain\-ixfr\-base \fIboolean\fR; // obsolete
 
255
        max\-ixfr\-log\-size \fIsize\fR; // obsolete
 
256
        multiple\-cnames \fIboolean\fR; // obsolete
 
257
        named\-xfer \fIquoted_string\fR; // obsolete
 
258
        serial\-queries \fIinteger\fR; // obsolete
 
259
        treat\-cr\-as\-space \fIboolean\fR; // obsolete
 
260
        use\-id\-pool \fIboolean\fR; // obsolete
271
261
};
272
 
.sp
273
262
.fi
274
263
.SH "VIEW"
275
264
.sp
276
265
.nf
277
266
view \fIstring\fR \fIoptional_class\fR {
278
 
        match-clients { \fIaddress_match_element\fR; ... };
279
 
        match-destinations { \fIaddress_match_element\fR; ... };
280
 
        match-recursive-only \fIboolean\fR;
281
 
 
 
267
        match\-clients { \fIaddress_match_element\fR; ... };
 
268
        match\-destinations { \fIaddress_match_element\fR; ... };
 
269
        match\-recursive\-only \fIboolean\fR;
282
270
        key \fIstring\fR {
283
271
                algorithm \fIstring\fR;
284
272
                secret \fIstring\fR;
285
273
        };
286
 
 
287
274
        zone \fIstring\fR \fIoptional_class\fR {
288
275
                ...
289
276
        };
290
 
 
291
277
        server ( \fIipv4_address\fR | \fIipv6_address\fR ) {
292
278
                ...
293
279
        };
294
 
 
295
 
        trusted-keys {
 
280
        trusted\-keys {
296
281
                \fIstring\fR \fIinteger\fR \fIinteger\fR \fIinteger\fR \fIquoted_string\fR; ...
297
282
        };
298
 
 
299
 
        allow-recursion { \fIaddress_match_element\fR; ... };
 
283
        allow\-recursion { \fIaddress_match_element\fR; ... };
300
284
        sortlist { \fIaddress_match_element\fR; ... };
301
285
        topology { \fIaddress_match_element\fR; ... }; // not implemented
302
 
        auth-nxdomain \fIboolean\fR; // default changed
303
 
        minimal-responses \fIboolean\fR;
 
286
        auth\-nxdomain \fIboolean\fR; // default changed
 
287
        minimal\-responses \fIboolean\fR;
304
288
        recursion \fIboolean\fR;
305
 
        rrset-order {
 
289
        rrset\-order {
306
290
                [ class \fIstring\fR ] [ type \fIstring\fR ]
307
291
                [ name \fIquoted_string\fR ] \fIstring\fR \fIstring\fR; ...
308
292
        };
309
 
        provide-ixfr \fIboolean\fR;
310
 
        request-ixfr \fIboolean\fR;
311
 
        rfc2308-type1 \fIboolean\fR; // not yet implemented
312
 
        additional-from-auth \fIboolean\fR;
313
 
        additional-from-cache \fIboolean\fR;
314
 
        query-source \fIquerysource4\fR;
315
 
        query-source-v6 \fIquerysource6\fR;
316
 
        cleaning-interval \fIinteger\fR;
317
 
        min-roots \fIinteger\fR; // not implemented
318
 
        lame-ttl \fIinteger\fR;
319
 
        max-ncache-ttl \fIinteger\fR;
320
 
        max-cache-ttl \fIinteger\fR;
321
 
        transfer-format ( many-answers | one-answer );
322
 
        max-cache-size \fIsize_no_default\fR;
323
 
        check-names ( master | slave | response )
 
293
        provide\-ixfr \fIboolean\fR;
 
294
        request\-ixfr \fIboolean\fR;
 
295
        rfc2308\-type1 \fIboolean\fR; // not yet implemented
 
296
        additional\-from\-auth \fIboolean\fR;
 
297
        additional\-from\-cache \fIboolean\fR;
 
298
        query\-source \fIquerysource4\fR;
 
299
        query\-source\-v6 \fIquerysource6\fR;
 
300
        cleaning\-interval \fIinteger\fR;
 
301
        min\-roots \fIinteger\fR; // not implemented
 
302
        lame\-ttl \fIinteger\fR;
 
303
        max\-ncache\-ttl \fIinteger\fR;
 
304
        max\-cache\-ttl \fIinteger\fR;
 
305
        transfer\-format ( many\-answers | one\-answer );
 
306
        max\-cache\-size \fIsize_no_default\fR;
 
307
        check\-names ( master | slave | response )
324
308
                ( fail | warn | ignore );
325
 
        cache-file \fIquoted_string\fR;
326
 
        suppress-initial-notify \fIboolean\fR; // not yet implemented
327
 
        preferred-glue \fIstring\fR;
328
 
        dual-stack-servers [ port \fIinteger\fR ] {
 
309
        cache\-file \fIquoted_string\fR;
 
310
        suppress\-initial\-notify \fIboolean\fR; // not yet implemented
 
311
        preferred\-glue \fIstring\fR;
 
312
        dual\-stack\-servers [ port \fIinteger\fR ] {
329
313
                ( \fIquoted_string\fR [port \fIinteger\fR] |
330
314
                \fIipv4_address\fR [port \fIinteger\fR] |
331
315
                \fIipv6_address\fR [port \fIinteger\fR] ); ...
332
316
        };
333
 
        edns-udp-size \fIinteger\fR;
334
 
        root-delegation-only [ exclude { \fIquoted_string\fR; ... } ];
335
 
        disable-algorithms \fIstring\fR { \fIstring\fR; ... };
336
 
        dnssec-enable \fIboolean\fR;
337
 
        dnssec-lookaside \fIstring\fR trust-anchor \fIstring\fR;
338
 
 
339
 
        dnssec-must-be-secure \fIstring\fR \fIboolean\fR;
 
317
        edns\-udp\-size \fIinteger\fR;
 
318
        root\-delegation\-only [ exclude { \fIquoted_string\fR; ... } ];
 
319
        disable\-algorithms \fIstring\fR { \fIstring\fR; ... };
 
320
        dnssec\-enable \fIboolean\fR;
 
321
        dnssec\-lookaside \fIstring\fR trust\-anchor \fIstring\fR;
 
322
        dnssec\-must\-be\-secure \fIstring\fR \fIboolean\fR;
340
323
        dialup \fIdialuptype\fR;
341
 
        ixfr-from-differences \fIixfrdiff\fR;
342
 
 
343
 
        allow-query { \fIaddress_match_element\fR; ... };
344
 
        allow-transfer { \fIaddress_match_element\fR; ... };
345
 
        allow-update-forwarding { \fIaddress_match_element\fR; ... };
346
 
 
 
324
        ixfr\-from\-differences \fIixfrdiff\fR;
 
325
        allow\-query { \fIaddress_match_element\fR; ... };
 
326
        allow\-transfer { \fIaddress_match_element\fR; ... };
 
327
        allow\-update\-forwarding { \fIaddress_match_element\fR; ... };
347
328
        notify \fInotifytype\fR;
348
 
        notify-source ( \fIipv4_address\fR | * ) [ port ( \fIinteger\fR | * ) ];
349
 
        notify-source-v6 ( \fIipv6_address\fR | * ) [ port ( \fIinteger\fR | * ) ];
350
 
        also-notify [ port \fIinteger\fR ] { ( \fIipv4_address\fR | \fIipv6_address\fR )
 
329
        notify\-source ( \fIipv4_address\fR | * ) [ port ( \fIinteger\fR | * ) ];
 
330
        notify\-source\-v6 ( \fIipv6_address\fR | * ) [ port ( \fIinteger\fR | * ) ];
 
331
        also\-notify [ port \fIinteger\fR ] { ( \fIipv4_address\fR | \fIipv6_address\fR )
351
332
                [ port \fIinteger\fR ]; ... };
352
 
        allow-notify { \fIaddress_match_element\fR; ... };
353
 
 
 
333
        allow\-notify { \fIaddress_match_element\fR; ... };
354
334
        forward ( first | only );
355
335
        forwarders [ port \fIinteger\fR ] {
356
336
                ( \fIipv4_address\fR | \fIipv6_address\fR ) [ port \fIinteger\fR ]; ...
357
337
        };
358
 
 
359
 
        max-journal-size \fIsize_no_default\fR;
360
 
        max-transfer-time-in \fIinteger\fR;
361
 
        max-transfer-time-out \fIinteger\fR;
362
 
        max-transfer-idle-in \fIinteger\fR;
363
 
        max-transfer-idle-out \fIinteger\fR;
364
 
        max-retry-time \fIinteger\fR;
365
 
        min-retry-time \fIinteger\fR;
366
 
        max-refresh-time \fIinteger\fR;
367
 
        min-refresh-time \fIinteger\fR;
368
 
        multi-master \fIboolean\fR;
369
 
        sig-validity-interval \fIinteger\fR;
370
 
 
371
 
        transfer-source ( \fIipv4_address\fR | * )
372
 
                [ port ( \fIinteger\fR | * ) ];
373
 
        transfer-source-v6 ( \fIipv6_address\fR | * )
374
 
                [ port ( \fIinteger\fR | * ) ];
375
 
 
376
 
        alt-transfer-source ( \fIipv4_address\fR | * )
377
 
                [ port ( \fIinteger\fR | * ) ];
378
 
        alt-transfer-source-v6 ( \fIipv6_address\fR | * )
379
 
                [ port ( \fIinteger\fR | * ) ];
380
 
        use-alt-transfer-source \fIboolean\fR;
381
 
 
382
 
        zone-statistics \fIboolean\fR;
383
 
        key-directory \fIquoted_string\fR;
384
 
 
385
 
        allow-v6-synthesis { \fIaddress_match_element\fR; ... }; // obsolete
386
 
        fetch-glue \fIboolean\fR; // obsolete
387
 
        maintain-ixfr-base \fIboolean\fR; // obsolete
388
 
        max-ixfr-log-size \fIsize\fR; // obsolete
 
338
        max\-journal\-size \fIsize_no_default\fR;
 
339
        max\-transfer\-time\-in \fIinteger\fR;
 
340
        max\-transfer\-time\-out \fIinteger\fR;
 
341
        max\-transfer\-idle\-in \fIinteger\fR;
 
342
        max\-transfer\-idle\-out \fIinteger\fR;
 
343
        max\-retry\-time \fIinteger\fR;
 
344
        min\-retry\-time \fIinteger\fR;
 
345
        max\-refresh\-time \fIinteger\fR;
 
346
        min\-refresh\-time \fIinteger\fR;
 
347
        multi\-master \fIboolean\fR;
 
348
        sig\-validity\-interval \fIinteger\fR;
 
349
        transfer\-source ( \fIipv4_address\fR | * )
 
350
                [ port ( \fIinteger\fR | * ) ];
 
351
        transfer\-source\-v6 ( \fIipv6_address\fR | * )
 
352
                [ port ( \fIinteger\fR | * ) ];
 
353
        alt\-transfer\-source ( \fIipv4_address\fR | * )
 
354
                [ port ( \fIinteger\fR | * ) ];
 
355
        alt\-transfer\-source\-v6 ( \fIipv6_address\fR | * )
 
356
                [ port ( \fIinteger\fR | * ) ];
 
357
        use\-alt\-transfer\-source \fIboolean\fR;
 
358
        zone\-statistics \fIboolean\fR;
 
359
        key\-directory \fIquoted_string\fR;
 
360
        allow\-v6\-synthesis { \fIaddress_match_element\fR; ... }; // obsolete
 
361
        fetch\-glue \fIboolean\fR; // obsolete
 
362
        maintain\-ixfr\-base \fIboolean\fR; // obsolete
 
363
        max\-ixfr\-log\-size \fIsize\fR; // obsolete
389
364
};
390
 
.sp
391
365
.fi
392
366
.SH "ZONE"
393
367
.sp
394
368
.nf
395
369
zone \fIstring\fR \fIoptional_class\fR {
396
370
        type ( master | slave | stub | hint |
397
 
                forward | delegation-only );
 
371
                forward | delegation\-only );
398
372
        file \fIquoted_string\fR;
399
 
 
400
373
        masters [ port \fIinteger\fR ] {
401
374
                ( \fImasters\fR |
402
375
                \fIipv4_address\fR [port \fIinteger\fR] |
403
376
                \fIipv6_address\fR [ port \fIinteger\fR ] ) [ key \fIstring\fR ]; ...
404
377
        };
405
 
 
406
378
        database \fIstring\fR;
407
 
        delegation-only \fIboolean\fR;
408
 
        check-names ( fail | warn | ignore );
 
379
        delegation\-only \fIboolean\fR;
 
380
        check\-names ( fail | warn | ignore );
409
381
        dialup \fIdialuptype\fR;
410
 
        ixfr-from-differences \fIboolean\fR;
411
 
 
412
 
        allow-query { \fIaddress_match_element\fR; ... };
413
 
        allow-transfer { \fIaddress_match_element\fR; ... };
414
 
        allow-update { \fIaddress_match_element\fR; ... };
415
 
        allow-update-forwarding { \fIaddress_match_element\fR; ... };
416
 
        update-policy {
 
382
        ixfr\-from\-differences \fIboolean\fR;
 
383
        allow\-query { \fIaddress_match_element\fR; ... };
 
384
        allow\-transfer { \fIaddress_match_element\fR; ... };
 
385
        allow\-update { \fIaddress_match_element\fR; ... };
 
386
        allow\-update\-forwarding { \fIaddress_match_element\fR; ... };
 
387
        update\-policy {
417
388
                ( grant | deny ) \fIstring\fR
418
389
                ( name | subdomain | wildcard | self ) \fIstring\fR
419
390
                \fIrrtypelist\fR; ...
420
391
        };
421
 
 
422
392
        notify \fInotifytype\fR;
423
 
        notify-source ( \fIipv4_address\fR | * ) [ port ( \fIinteger\fR | * ) ];
424
 
        notify-source-v6 ( \fIipv6_address\fR | * ) [ port ( \fIinteger\fR | * ) ];
425
 
        also-notify [ port \fIinteger\fR ] { ( \fIipv4_address\fR | \fIipv6_address\fR )
 
393
        notify\-source ( \fIipv4_address\fR | * ) [ port ( \fIinteger\fR | * ) ];
 
394
        notify\-source\-v6 ( \fIipv6_address\fR | * ) [ port ( \fIinteger\fR | * ) ];
 
395
        also\-notify [ port \fIinteger\fR ] { ( \fIipv4_address\fR | \fIipv6_address\fR )
426
396
                [ port \fIinteger\fR ]; ... };
427
 
        allow-notify { \fIaddress_match_element\fR; ... };
428
 
 
 
397
        allow\-notify { \fIaddress_match_element\fR; ... };
429
398
        forward ( first | only );
430
399
        forwarders [ port \fIinteger\fR ] {
431
400
                ( \fIipv4_address\fR | \fIipv6_address\fR ) [ port \fIinteger\fR ]; ...
432
401
        };
433
 
 
434
 
        max-journal-size \fIsize_no_default\fR;
435
 
        max-transfer-time-in \fIinteger\fR;
436
 
        max-transfer-time-out \fIinteger\fR;
437
 
        max-transfer-idle-in \fIinteger\fR;
438
 
        max-transfer-idle-out \fIinteger\fR;
439
 
        max-retry-time \fIinteger\fR;
440
 
        min-retry-time \fIinteger\fR;
441
 
        max-refresh-time \fIinteger\fR;
442
 
        min-refresh-time \fIinteger\fR;
443
 
        multi-master \fIboolean\fR;
444
 
        sig-validity-interval \fIinteger\fR;
445
 
 
446
 
        transfer-source ( \fIipv4_address\fR | * )
447
 
                [ port ( \fIinteger\fR | * ) ];
448
 
        transfer-source-v6 ( \fIipv6_address\fR | * )
449
 
                [ port ( \fIinteger\fR | * ) ];
450
 
 
451
 
        alt-transfer-source ( \fIipv4_address\fR | * )
452
 
                [ port ( \fIinteger\fR | * ) ];
453
 
        alt-transfer-source-v6 ( \fIipv6_address\fR | * )
454
 
                [ port ( \fIinteger\fR | * ) ];
455
 
        use-alt-transfer-source \fIboolean\fR;
456
 
 
457
 
        zone-statistics \fIboolean\fR;
458
 
        key-directory \fIquoted_string\fR;
459
 
 
460
 
        ixfr-base \fIquoted_string\fR; // obsolete
461
 
        ixfr-tmp-file \fIquoted_string\fR; // obsolete
462
 
        maintain-ixfr-base \fIboolean\fR; // obsolete
463
 
        max-ixfr-log-size \fIsize\fR; // obsolete
 
402
        max\-journal\-size \fIsize_no_default\fR;
 
403
        max\-transfer\-time\-in \fIinteger\fR;
 
404
        max\-transfer\-time\-out \fIinteger\fR;
 
405
        max\-transfer\-idle\-in \fIinteger\fR;
 
406
        max\-transfer\-idle\-out \fIinteger\fR;
 
407
        max\-retry\-time \fIinteger\fR;
 
408
        min\-retry\-time \fIinteger\fR;
 
409
        max\-refresh\-time \fIinteger\fR;
 
410
        min\-refresh\-time \fIinteger\fR;
 
411
        multi\-master \fIboolean\fR;
 
412
        sig\-validity\-interval \fIinteger\fR;
 
413
        transfer\-source ( \fIipv4_address\fR | * )
 
414
                [ port ( \fIinteger\fR | * ) ];
 
415
        transfer\-source\-v6 ( \fIipv6_address\fR | * )
 
416
                [ port ( \fIinteger\fR | * ) ];
 
417
        alt\-transfer\-source ( \fIipv4_address\fR | * )
 
418
                [ port ( \fIinteger\fR | * ) ];
 
419
        alt\-transfer\-source\-v6 ( \fIipv6_address\fR | * )
 
420
                [ port ( \fIinteger\fR | * ) ];
 
421
        use\-alt\-transfer\-source \fIboolean\fR;
 
422
        zone\-statistics \fIboolean\fR;
 
423
        key\-directory \fIquoted_string\fR;
 
424
        ixfr\-base \fIquoted_string\fR; // obsolete
 
425
        ixfr\-tmp\-file \fIquoted_string\fR; // obsolete
 
426
        maintain\-ixfr\-base \fIboolean\fR; // obsolete
 
427
        max\-ixfr\-log\-size \fIsize\fR; // obsolete
464
428
        pubkey \fIinteger\fR \fIinteger\fR \fIinteger\fR \fIquoted_string\fR; // obsolete
465
429
};
466
 
.sp
467
430
.fi
468
431
.SH "FILES"
469
432
.PP
472
435
.PP
473
436
\fBnamed\fR(8),
474
437
\fBrndc\fR(8),
475
 
\fBBIND 9 Adminstrators Reference Manual\fR.
 
438
\fBBIND 9 Adminstrators Reference Manual\fR().