options revision 333fe280eb574439ef3f828d8755dd9e243ec855
1633838b8255282d10af15c5c84cee5a51466712Bob HalleyCopyright (C) 2000, 2001 Internet Software Consortium.
5dee04703805e9453ff4d8d77884391e3a185977Bob HalleySee COPYRIGHT in the source root or http://isc.org/copyright.html for terms.
1633838b8255282d10af15c5c84cee5a51466712Bob Halley
1633838b8255282d10af15c5c84cee5a51466712Bob Halley$Id: options,v 1.57 2001/01/16 20:44:26 gson Exp $
1633838b8255282d10af15c5c84cee5a51466712Bob Halley
1633838b8255282d10af15c5c84cee5a51466712Bob HalleyThis is a summary of the implementation status of the various named.conf
1633838b8255282d10af15c5c84cee5a51466712Bob Halleyoptions in BIND 9.
1633838b8255282d10af15c5c84cee5a51466712Bob Halley
1633838b8255282d10af15c5c84cee5a51466712Bob HalleyLegend:
1633838b8255282d10af15c5c84cee5a51466712Bob Halley
1633838b8255282d10af15c5c84cee5a51466712Bob Halley Yes Implemented in this release.
1633838b8255282d10af15c5c84cee5a51466712Bob Halley
1633838b8255282d10af15c5c84cee5a51466712Bob Halley No Not implemented, may be implemented in a later release.
1633838b8255282d10af15c5c84cee5a51466712Bob Halley
1633838b8255282d10af15c5c84cee5a51466712Bob Halley Obsolete Obsolete, not applicable to BIND 9, or just evil.
1633838b8255282d10af15c5c84cee5a51466712Bob Halley Will not be implemented.
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley * New in BIND 9.
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley + The option is now always enabled.
904a5734375869ffb504ed8cde6b68cafadb6d64Bob Halley
e4e071ae12aee942fefc2c0a3280e402938669deBob Halley - The option is now always disabled.
e4e071ae12aee942fefc2c0a3280e402938669deBob Halley
904a5734375869ffb504ed8cde6b68cafadb6d64Bob Halley % The default value has changed since BIND 8.
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley & The option has been extended since BIND 8.
904a5734375869ffb504ed8cde6b68cafadb6d64Bob Halley
904a5734375869ffb504ed8cde6b68cafadb6d64Bob Halley @ Semantics of certain pathological address match lists, in
e4e071ae12aee942fefc2c0a3280e402938669deBob Halley particular those involving double negation, have changed.
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley The new semantics are generally safer. IPv6 addresses
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley are supported, but the predefined ACLs "localhost" and
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley "localnets" match IPv4 addresses only.
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington # BIND 9 accepts both LF and CRLF as end-of-line markers.
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington $ Stub zones are partially supported. They no longer
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington inject NS records into their parent zones, but can still
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington be used as a way of forcing a domain to be resolved using
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington a particular set of name servers.
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellingtonoptions {
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ version version_string; ] Yes
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ directory path_name; ] Yes
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ named-xfer path_name; ] Obsolete
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley [ dump-file path_name; ] Yes
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ memstatistics-file path_name; ] No
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ pid-file path_name; ] Yes
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ statistics-file path_name; ] Yes
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ auth-nxdomain yes_or_no; ] Yes%
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ deallocate-on-exit yes_or_no; ] Obsolete+
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ dialup yes_or_no | notify | notify-passive |
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington refresh | passive; ] Yes&
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ fake-iquery yes_or_no; ] Obsolete-
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ fetch-glue yes_or_no; ] Obsolete
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ has-old-clients yes_or_no; ] Obsolete
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ host-statistics yes_or_no; ] No
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ multiple-cnames yes_or_no; ] Obsolete-
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ notify yes_or_no | explicit; ] Yes&
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ recursion yes_or_no; ] Yes
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ rfc2308-type1 yes_or_no; ] No
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ use-id-pool yes_or_no; ] Obsolete+
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ use-ixfr yes_or_no; ] Obsolete
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ treat-cr-as-space yes_or_no; ] Obsolete#
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ also-notify { ip_addr; [ ip_addr; ... ] }; ] Yes
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ forward ( only | first ); ] Yes
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ forwarders { [ in_addr ; [ in_addr ; ... ] ] }; ] Yes
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ check-names ... ] Obsolete
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ allow-notify { address_match_list }; ] Yes*
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ allow-query { address_match_list }; ] Yes@
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ allow-transfer { address_match_list }; ] Yes@
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ allow-recursion { address_match_list }; ] Yes@
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ blackhole { address_match_list }; ] Yes
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ listen-on [ port ip_port ] { address_match_list }; ] Yes@
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ listen-on-v6 [ port ip_port ] { address_match_list }; ] Yes*
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ query-source ... ] Yes
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ query-source-v6 ... ] Yes*
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ lame-ttl number; ] Yes
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ max-transfer-time-in number; ] Yes
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ max-transfer-idle-in number; ] Yes*
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ max-transfer-time-out number; ] Yes*
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ max-transfer-idle-out number; ] Yes*
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ max-cache-ttl number; ] Yes*
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ max-ncache-ttl number; ] Yes
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ max-cache-size size_spec; ] No*
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ min-roots number; ] Obsolete
308c7ad5f68301d19f023af616f62f3e7cbce632Andreas Gustafsson [ serial-queries number; ] Obsolete
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ transfer-format ( one-answer | many-answers ); ] Yes
308c7ad5f68301d19f023af616f62f3e7cbce632Andreas Gustafsson [ transfers-in number; ] Yes
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ transfers-out number; ] Yes
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ transfers-per-ns number; ] Yes
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ transfer-source ip_addr; ] Yes
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ transfer-source-v6 ip_addr; ] Yes*
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ request-ixfr yes_or_no; ] Yes*
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ provide-ixfr yes_or_no; ] Yes*
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ maintain-ixfr-base yes_or_no; ] Obsolete
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ max-ixfr-log-size number; ] Obsolete
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ coresize size_spec ; ] Yes
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ datasize size_spec ; ] Yes
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ files size_spec ; ] Yes
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ stacksize size_spec ; ] Yes
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ cleaning-interval number; ] Yes
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ heartbeat-interval number; ] Yes
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ interface-interval number; ] Yes
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ statistics-interval number; ] No
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ topology { address_match_list }; ] No
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ sortlist { address_match_list }; ] Yes
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ rrset-order { order_spec ; [ order_spec ; ... ] }; ] No
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ recursive-clients number; ] Yes*
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ tcp-clients number; ] Yes*
125d72976ab6b8fa6629a5ace276a86e9fef91acBrian Wellington [ tkey-domain ... ] Yes*
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ tkey-dhkey ... ] Yes*
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ min-refresh-time number ; ] Yes*
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley [ max-refresh-time number ; ] Yes*
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ min-retry-time number ; ] Yes*
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ max-retry-time number ; ] Yes*
25e43e68b7431d5e4ff8b5427108cd7f5f9bcf3eBob Halley [ port number; ] Yes*
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley [ sig-validity-interval number; ] Yes*
904a5734375869ffb504ed8cde6b68cafadb6d64Bob Halley [ additional-from-auth yes_or_no; ] Yes*
904a5734375869ffb504ed8cde6b68cafadb6d64Bob Halley [ additional-from-cache yes_or_no; ] Yes*
c50fd34a4e0e6978f8ca5f6f3ad8545549c3cfeeBob Halley [ random-device path_name; ] Yes*
};
acl Yes@
include Yes
key Yes
logging Yes
controls {
[ inet ... ] Yes%
[ unix ... ] Obsolete
};
server ip_addr {
[ bogus yes_or_no; ] Yes
[ request-ixfr yes_or_no; ] Yes*
[ provide-ixfr yes_or_no; ] Yes*
[ support-ixfr yes_or_no; ] Obsolete
[ transfers number; ] Yes
[ transfer-format ( one-answer | many-answers ); ] Yes
[ keys { key_id [key_id ... ] }; ] Yes
};
trusted-keys Yes
zone "domain_name" [ ( in | hs | hesiod | chaos ) ] {
type master; Yes
file path_name; Yes
[ forward ( only | first ); ] Yes
[ forwarders { [ ip_addr ; [ ip_addr ; ... ] ] }; ] Yes
[ check-names ( warn | fail | ignore ); ] Obsolete
[ allow-update { address_match_list }; ] Yes@
[ update-policy ... ] Yes*
[ allow-query { address_match_list }; ] Yes@
[ allow-transfer { address_match_list }; ] Yes@
[ dialup yes_or_no | notify; ] Yes&
[ max-transfer-time-out number; ] Yes*
[ max-transfer-idle-out number; ] Yes*
[ notify yes_or_no | explicit; ] Yes&
[ also-notify { ip_addr; [ ip_addr; ... ] }; ] Yes
[ ixfr-base path_name; ] Obsolete
[ pubkey number number number string; ] No
[ sig-validity-interval number; ] Yes*
[ database string ; [string; ... ] ] Yes*
[ min-refresh-time number ; ] Yes*
[ max-refresh-time number ; ] Yes*
[ min-retry-time number ; ] Yes*
[ max-retry-time number ; ] Yes*
};
zone "domain_name" [ ( in | hs | hesiod | chaos ) ] {
type slave; Yes
[ file path_name; ] Yes
[ ixfr-base path_name; ] Obsolete
masters [ port ip_port ] { ip_addr; [ ip_addr; ... ] }; Yes
[ forward ( only | first ); ] Yes
[ forwarders { [ ip_addr ; [ ip_addr ; ... ] ] }; ] Yes
[ check-names ( warn | fail | ignore ); ] Obsolete
[ allow-notify { address_match_list };] Yes*
[ allow-update { address_match_list }; ] Obsolete
[ allow-update-forwarding { address_match_list }; ] No*
[ allow-query { address_match_list }; ] Yes@
[ allow-transfer { address_match_list }; ] Yes@
[ transfer-source ip_addr; ] Yes
[ transfer-source-v6 ip_addr; ] Yes*
[ dialup yes_or_no | notify | notify-passive |
refresh | passive; ] Yes&
[ max-transfer-time-in number; ] Yes
[ max-transfer-idle-in number; ] Yes*
[ max-transfer-time-out number; ] Yes*
[ max-transfer-idle-out number; ] Yes*
[ notify yes_or_no | explicit; ] Yes&
[ also-notify { ip_addr; [ ip_addr; ... ] }; ] Yes
[ pubkey number number number string; ] No
[ min-refresh-time number ; ] Yes*
[ max-refresh-time number ; ] Yes*
[ min-retry-time number ; ] Yes*
[ max-retry-time number ; ] Yes*
};
zone "domain_name" [ ( in | hs | hesiod | chaos ) ] {
type stub; Yes$
[ file path_name; ] Yes
masters [ port ip_port ] { ip_addr; [ ip_addr; ... ] }; Yes
[ forward ( only | first ); ] Yes
[ forwarders { [ ip_addr ; [ ip_addr ; ... ] ] }; ] Yes
[ check-names ( warn | fail | ignore ); ] Obsolete
[ allow-update { address_match_list }; ] Obsolete
[ allow-update-forwarding { address_match_list }; ] Yes*
[ allow-query { address_match_list }; ] Yes@
[ allow-transfer { address_match_list }; ] Yes@
[ transfer-source ip_addr; ] Yes
[ transfer-source-v6 ip_addr; ] Yes*
[ dialup yes_or_no | passive | refresh; ] Yes%
[ 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
[ min-refresh-time number ; ] Yes*
[ max-refresh-time number ; ] Yes*
[ min-retry-time number ; ] Yes*
[ max-retry-time number ; ] Yes*
};
zone "domain_name" [ ( in | hs | hesiod | chaos ) ] {
type forward; Yes
[ forward ( only | first ); ] Yes
[ forwarders { [ ip_addr ; [ ip_addr ; ... ] ] }; ] Yes
};
zone "." [ ( in | hs | hesiod | chaos ) ] {
type hint; Yes
file path_name; Yes
[ check-names ( warn | fail | ignore ); ] Obsolete
};
view "view_name" [ ( in | hs | hesiod | chaos ) ] { Yes*
match-clients { address_match_list }; Yes*
[ zone ... ] Yes
[ auth-nxdomain yes_or_no; ] Yes
[ fetch-glue yes_or_no; ] Obsolete
[ notify yes_or_no | explicit; ] Yes&
[ recursion yes_or_no; ] Yes
[ rfc2308-type1 yes_or_no; ] No
[ also-notify { ip_addr; [ ip_addr; ... ] }; ] Yes
[ forward ( only | first ); ] Yes
[ forwarders { [ in_addr ; [ in_addr ; ... ] ] }; ] Yes
[ check-names ... ] Obsolete
[ allow-notify { address_match_list }; ] Yes
[ 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
[ lame-ttl number; ] Yes
[ max-transfer-time-out number; ] Yes*
[ max-transfer-idle-out number; ] Yes*
[ max-cache-ttl number; ] Yes*
[ max-ncache-ttl number; ] Yes
[ max-cache-size size_spec; ] No*
[ min-roots number; ] Obsolete
[ 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
[ sortlist { address_match_list }; ] Yes
[ rrset-order { order_spec ; [ order_spec ; ... ] }; ] No
[ key ... ] Yes
[ server ... ] Yes
[ trusted-keys ... ] Yes
[ sig-validity-interval number; ] Yes*
[ min-refresh-time number ; ] Yes*
[ max-refresh-time number ; ] Yes*
[ min-retry-time number ; ] Yes*
[ max-retry-time number ; ] Yes*
};