options 9.22 KB
Newer Older
David Lawrence's avatar
David Lawrence committed
1
Copyright (C) 2000  Internet Software Consortium.
Andreas Gustafsson's avatar
Andreas Gustafsson committed
2
See COPYRIGHT in the source root or http://isc.org/copyright.html for terms.
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
3

4
$Id: options,v 1.43 2000/11/20 21:49:16 bwelling Exp $
David Lawrence's avatar
David Lawrence committed
5

Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
6
7
8
9
10
This is a summary of the implementation status of the various named.conf
options in BIND 9.

Legend:

11
  Yes	    Implemented in this release.
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
12

13
  No	    Not implemented, may be implemented in a later release.
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
14

15
  Obsolete  Obsolete, not applicable to BIND 9, or just evil.
16
	    Will not be implemented.
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
17

18
  *	    New in BIND 9.
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
19

20
  +	    The option is now always enabled.
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
21

22
  -	    The option is now always disabled.
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
23

24
  %	    The default value has changed since BIND 8.
25

Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
26
  @	    Semantics of certain pathological address match lists, in
27
	    particular those involving double negation, have changed.
28
	    The new semantics are generally safer.  IPv6 addresses
29
	    are supported, but the predefined ACLs "localhost" and
30
	    "localnets" match IPv4 addresses only.
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
31

32
  #	    BIND 9 accepts both LF and CRLF as end-of-line markers.
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
33
34
35
36
37
38
39
40
41
42
43
44


options {
  [ version version_string; ]				    Yes
  [ directory path_name; ]				    Yes
  [ named-xfer path_name; ]				    Obsolete
  [ dump-file path_name; ]				    No
  [ memstatistics-file path_name; ]			    No
  [ pid-file path_name; ]				    Yes
  [ statistics-file path_name; ]			    No
  [ auth-nxdomain yes_or_no; ]				    Yes%
  [ deallocate-on-exit yes_or_no; ]			    Obsolete+
45
  [ dialup yes_or_no; ]					    Yes
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
46
  [ fake-iquery yes_or_no; ]				    Obsolete-
Andreas Gustafsson's avatar
Andreas Gustafsson committed
47
  [ fetch-glue yes_or_no; ]				    Obsolete
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
48
49
50
  [ has-old-clients yes_or_no; ]			    Obsolete
  [ host-statistics yes_or_no; ]			    No
  [ multiple-cnames yes_or_no; ]			    Obsolete-
51
  [ notify yes_or_no; ]					    Yes
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
52
53
54
  [ recursion yes_or_no; ]				    Yes
  [ rfc2308-type1 yes_or_no; ]				    No
  [ use-id-pool yes_or_no; ]				    Obsolete+
55
  [ treat-cr-as-space yes_or_no; ]			    Obsolete#
56
  [ also-notify { ip_addr; [ ip_addr; ... ] }; ]	    Yes
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
57
58
  [ forward ( only | first ); ]				    Yes
  [ forwarders { [ in_addr ; [ in_addr ; ... ] ] }; ]	    Yes
59
  [ check-names ... ]					    No
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
60
61
62
  [ allow-query { address_match_list }; ]		    Yes@
  [ allow-transfer { address_match_list }; ]		    Yes@
  [ allow-recursion { address_match_list }; ]		    Yes@
63
  [ blackhole { address_match_list }; ]			    Yes
Andreas Gustafsson's avatar
Andreas Gustafsson committed
64
65
  [ listen-on [ port ip_port ] { address_match_list }; ]    Yes@
  [ listen-on-v6 [ port ip_port ] { address_match_list }; ] Yes*
66
67
  [ query-source ... ]					    Yes
  [ query-source-v6 ... ]				    Yes*
Mark Andrews's avatar
Mark Andrews committed
68
  [ lame-ttl number; ]					    Yes
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
69
70
71
72
  [ max-transfer-time-in number; ]			    Yes
  [ max-transfer-idle-in number; ]			    Yes*
  [ max-transfer-time-out number; ]			    Yes*
  [ max-transfer-idle-out number; ]			    Yes*
73
74
  [ max-cache-ttl number; ]				    Yes*
  [ max-ncache-ttl number; ]				    Yes
75
  [ max-cache-size size_spec; ]				    No*
76
77
  [ min-roots number; ]					    Obsolete
  [ serial-queries number; ]				    Obsolete
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
78
  [ transfer-format ( one-answer | many-answers ); ]	    Yes
79
  [ transfers-in  number; ]				    Yes
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
80
  [ transfers-out number; ]				    Yes
81
  [ transfers-per-ns number; ]				    Yes
Andreas Gustafsson's avatar
Andreas Gustafsson committed
82
83
  [ transfer-source ip_addr; ]				    Yes
  [ transfer-source-v6 ip_addr; ]			    Yes*
84
  [ request-ixfr yes_or_no; ]				    Yes*
85
86
  [ provide-ixfr yes_or_no; ]				    Yes*
  [ maintain-ixfr-base yes_or_no; ]			    Obsolete
87
  [ max-ixfr-log-size number; ]				    Obsolete
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
88
89
90
91
92
  [ coresize size_spec ; ]				    No
  [ datasize size_spec ; ]				    No
  [ files size_spec ; ]					    No
  [ stacksize size_spec ; ]				    No
  [ cleaning-interval number; ]				    Yes
93
  [ heartbeat-interval number; ]			    Yes
94
  [ interface-interval number; ]			    Yes
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
95
96
97
  [ statistics-interval number; ]			    No
  [ topology { address_match_list }; ]			    No
  [ sortlist { address_match_list }; ]			    No
98
  [ rrset-order { order_spec ; [ order_spec ; ... ] }; ]    No
99
100
  [ recursive-clients number; ]				    Yes*
  [ tcp-clients number; ]				    Yes*
101
102
  [ tkey-domain ... ]					    Yes*
  [ tkey-dhkey ... ]					    Yes*
Andreas Gustafsson's avatar
Andreas Gustafsson committed
103
  [ port number; ]					    Yes*
104
  [ sig-validity-interval number; ]			    Yes*
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
105
106
};

107
acl							    Yes@
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
108

109
include							    Yes
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
110
111
112

key							    Yes

113
logging							    Yes
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
114

115
116
117
118
controls {
  [ inet ... ]						    Yes%
  [ unix ... ]						    Obsolete
};
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
119

120
server ip_addr {
121
  [ bogus yes_or_no; ]					    Yes
122
  [ request-ixfr yes_or_no; ]				    Yes*
123
  [ provide-ixfr yes_or_no; ]				    Yes*
124
  [ support-ixfr yes_or_no; ]				    Obsolete
125
  [ transfers number; ]					    Yes
126
  [ transfer-format ( one-answer | many-answers ); ]	    Yes
127
  [ keys { key_id [key_id ... ] }; ]			    Yes
128
};
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
129

130
trusted-keys						    Yes
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
131

132
zone "domain_name" [ ( in | hs | hesiod | chaos ) ] {
133
  type master;						    Yes
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
134
  file path_name;					    Yes
135
136
  [ forward ( only | first ); ]				    Yes
  [ forwarders { [ ip_addr ; [ ip_addr ; ... ] ] }; ]	    Yes
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
137
138
  [ check-names ( warn | fail | ignore ); ]		    No
  [ allow-update { address_match_list }; ]		    Yes@
139
  [ update-policy ... ]					    Yes*
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
140
141
142
  [ allow-query { address_match_list }; ]		    Yes@
  [ allow-transfer { address_match_list }; ]		    Yes@
  [ dialup yes_or_no; ]					    No
143
144
  [ max-transfer-time-out number; ]			    Yes*
  [ max-transfer-idle-out number; ]			    Yes*
145
146
  [ notify yes_or_no; ]					    Yes
  [ also-notify { ip_addr; [ ip_addr; ... ] };		    Yes
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
147
148
  [ ixfr-base  path_name; ]				    Obsolete
  [ pubkey number number number string; ]		    No
149
  [ sig-validity-interval number; ]			    Yes*
150
  [ database string ; [string; ... ] ]			    Yes*
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
151
152
};

153
zone "domain_name" [ ( in | hs | hesiod | chaos ) ] {
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
154
155
156
157
  type slave;						    Yes
  [ file path_name; ]					    Yes
  [ ixfr-base  path_name; ]				    Obsolete
  masters [ port ip_port ] { ip_addr; [ ip_addr; ... ] };   Yes
158
159
  [ forward ( only | first ); ]				    Yes
  [ forwarders { [ ip_addr ; [ ip_addr ; ... ] ] }; ]	    Yes
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
160
  [ check-names ( warn | fail | ignore ); ]		    No
161
  [ allow-update { address_match_list }; ]		    Obsolete
162
  [ allow-update-forwarding { address_match_list }; ]	    No*
163
164
  [ allow-query { address_match_list }; ]		    Yes@
  [ allow-transfer { address_match_list }; ]		    Yes@
Andreas Gustafsson's avatar
Andreas Gustafsson committed
165
166
  [ transfer-source ip_addr; ]				    Yes
  [ transfer-source-v6 ip_addr; ]			    Yes*
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
167
168
169
170
171
  [ dialup yes_or_no; ]					    No
  [ max-transfer-time-in number; ]			    Yes
  [ max-transfer-idle-in number; ]			    Yes*
  [ max-transfer-time-out number; ]			    Yes*
  [ max-transfer-idle-out number; ]			    Yes*
172
173
  [ notify yes_or_no; ]					    Yes
  [ also-notify { ip_addr; [ ip_addr; ... ] };		    Yes
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
174
175
176
  [ pubkey number number number string; ]		    No
};

177
178
179
180
zone "domain_name" [ ( in | hs | hesiod | chaos ) ] {
  type stub;						    Yes
  [ file path_name; ]					    Yes
  masters [ port ip_port ] { ip_addr; [ ip_addr; ... ] };   Yes
181
182
  [ forward ( only | first ); ]				    Yes
  [ forwarders { [ ip_addr ; [ ip_addr ; ... ] ] }; ]	    Yes
183
184
  [ check-names ( warn | fail | ignore ); ]		    No
  [ allow-update { address_match_list }; ]		    Obsolete
185
  [ allow-update-forwarding { address_match_list }; ]	    Yes*
186
187
188
189
  [ allow-query { address_match_list }; ]		    Yes@
  [ allow-transfer { address_match_list }; ]		    Yes@
  [ transfer-source ip_addr; ]				    Yes
  [ transfer-source-v6 ip_addr; ]			    Yes*
190
  [ dialup yes_or_no; ]					    Yes
191
192
193
194
195
196
197
  [ max-transfer-time-in number; ]			    Yes
  [ max-transfer-idle-in number; ]			    Yes*
  [ max-transfer-time-out number; ]			    Yes*
  [ max-transfer-idle-out number; ]			    Yes*
  [ pubkey number number number string; ]		    No
};

198
zone "domain_name" [ ( in | hs | hesiod | chaos ) ] {
199
200
201
  type forward;						    Yes
  [ forward ( only | first ); ]				    Yes
  [ forwarders { [ ip_addr ; [ ip_addr ; ... ] ] }; ]	    Yes
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
202
203
};

204
zone "." [ ( in | hs | hesiod | chaos ) ] {
Andreas Gustafsson's avatar
created  
Andreas Gustafsson committed
205
206
207
208
  type hint;						    Yes
  file path_name;					    Yes
  [ check-names ( warn | fail | ignore ); ]		    No
};
209
210
211
212
213

view "view_name" [ ( in | hs | hesiod | chaos ) ] {	    Yes*
  match-clients { address_match_list };			    Yes*
  [ zone ... ]						    Yes
  [ auth-nxdomain yes_or_no; ]				    Yes
Andreas Gustafsson's avatar
Andreas Gustafsson committed
214
  [ fetch-glue yes_or_no; ]				    Obsolete
215
216
217
  [ notify yes_or_no; ]					    Yes
  [ recursion yes_or_no; ]				    Yes
  [ rfc2308-type1 yes_or_no; ]				    No
218
  [ also-notify { ip_addr; [ ip_addr; ... ] }; ]	    Yes
219
220
221
222
223
224
225
226
  [ forward ( only | first ); ]				    Yes
  [ forwarders { [ in_addr ; [ in_addr ; ... ] ] }; ]	    Yes
  [ check-names ... ]					    No
  [ allow-query { address_match_list }; ]		    Yes
  [ allow-transfer { address_match_list }; ]		    Yes
  [ allow-recursion { address_match_list }; ]		    Yes
  [ query-source ... ]					    Yes
  [ query-source-v6 ... ]				    Yes
227
  [ lame-ttl number; ]					    Yes
228
229
  [ max-transfer-time-out number; ]			    Yes*
  [ max-transfer-idle-out number; ]			    Yes*
230
231
  [ max-cache-ttl number; ]				    Yes*
  [ max-ncache-ttl number; ]				    Yes
232
  [ max-cache-size size_spec; ]				    No*
233
  [ min-roots number; ]					    Obsolete
234
235
236
237
238
239
240
  [ transfer-format ( one-answer | many-answers ); ]	    Yes
  [ transfer-source ip_addr; ]				    Yes
  [ transfer-source-v6 ip_addr; ]			    Yes*
  [ request-ixfr yes_or_no; ]				    Yes*
  [ provide-ixfr yes_or_no;]				    Yes*
  [ cleaning-interval number; ]				    Yes
  [ topology { address_match_list }; ]			    No
241
  [ sortlist { address_match_list }; ]			    No
242
  [ rrset-order { order_spec ; [ order_spec ; ... ] }; ]    No
243
244
  [ key ... ]						    Yes
  [ server ... ]					    Yes
245
  [ trusted-keys ... ]					    Yes
246
  [ sig-validity-interval number; ]			    Yes*
247
};