NAME
named.conf − configuration file for named
SYNOPSIS
named.conf
DESCRIPTION
named.conf is the configuration file for named. 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:
C style: /* */
C++ style: // to end of line
Unix style: # to end of line
ACL
acl string { address_match_element; ... };
KEY
key domain_name {
| 
 algorithm string;  | ||
| 
 secret string;  | 
};
SERVER
server ( ipv4_address | ipv6_address ) {
| 
 bogus boolean;  | 
|||
| 
 edns boolean;  | 
|||
| 
 provide-ixfr boolean;  | 
|||
| 
 request-ixfr boolean;  | 
|||
| 
 keys server_key;  | 
|||
| 
 transfers integer;  | 
|||
| 
 transfer-format ( many-answers | one-answer );  | 
|||
| 
 transfer-source ( ipv4_address | * )  | 
|||
| 
 [ port ( integer | * ) ];  | |||
| 
 transfer-source-v6 ( ipv6_address | * )  | 
|||
| 
 [ port ( integer | * ) ];  | |||
| 
 support-ixfr boolean; // obsolete  | 
};
TRUSTED-KEYS
trusted-keys {
| 
 domain_name flags protocol algorithm key; ...  | 
};
CONTROLS
controls {
| 
 inet ( ipv4_address | ipv6_address | * )  | 
|||
| 
 [ port ( integer | * ) ]  | |||
| 
 allow { address_match_element; ... }  | |||
| 
 [ keys { string; ... } ];  | |||
| 
 unix unsupported; // not implemented  | 
};
LOGGING
logging {
| 
 channel string {  | 
|||
| 
 file log_file;  | |||
| 
 syslog optional_facility;  | |||
| 
 null;  | |||
| 
 stderr;  | |||
| 
 severity log_severity;  | |||
| 
 print-time boolean;  | |||
| 
 print-severity boolean;  | |||
| 
 print-category boolean;  | |||
| 
 };  | 
|||
| 
 category string { string; ... };  | 
};
LWRES
lwres {
| 
 listen-on [ port integer ] {  | 
|||
| 
 ( ipv4_address | ipv6_address ) [ port integer ]; ...  | |||
| 
 };  | 
|||
| 
 view string optional_class;  | 
|||
| 
 search { string; ... };  | 
|||
| 
 ndots integer;  | 
};
OPTIONS
options {
| 
 blackhole { address_match_element; ... };  | 
|||
| 
 coresize size;  | 
|||
| 
 datasize size;  | 
|||
| 
 directory quoted_string;  | 
|||
| 
 dump-file quoted_string;  | 
|||
| 
 files size;  | 
|||
| 
 heartbeat-interval integer;  | 
|||
| 
 host-statistics boolean; // not implemented  | 
|||
| 
 interface-interval integer;  | 
|||
| 
 listen-on [ port integer ] { address_match_element; ... };  | 
|||
| 
 listen-on-v6 [ port integer ] { address_match_element; ... };  | 
|||
| 
 match-mapped-addresses boolean;  | 
|||
| 
 memstatistics-file quoted_string; // not implemented  | 
|||
| 
 pid-file quoted_string;  | 
|||
| 
 port integer;  | 
|||
| 
 random-device quoted_string;  | 
|||
| 
 recursive-clients integer;  | 
|||
| 
 serial-query-rate integer;  | 
|||
| 
 stacksize size;  | 
|||
| 
 statistics-file quoted_string;  | 
|||
| 
 statistics-interval integer; // not yet implemented  | 
|||
| 
 tcp-clients integer;  | 
|||
| 
 tkey-dhkey quoted_string integer;  | 
|||
| 
 tkey-gssapi-credential quoted_string;  | 
|||
| 
 tkey-domain quoted_string;  | 
|||
| 
 transfers-per-ns integer;  | 
|||
| 
 transfers-in integer;  | 
|||
| 
 transfers-out integer;  | 
|||
| 
 use-ixfr boolean;  | 
|||
| 
 version quoted_string;  | 
|||
| 
 allow-recursion { address_match_element; ... };  | 
|||
| 
 sortlist { address_match_element; ... };  | 
|||
| 
 topology { address_match_element; ... }; // not implemented  | 
|||
| 
 auth-nxdomain boolean; // default changed  | 
|||
| 
 minimal-responses boolean;  | 
|||
| 
 recursion boolean;  | 
|||
| 
 rrset-order {  | 
|||
| 
 [ class string ] [ type string ]  | |||
| 
 [ name quoted_string ] string string; ...  | |||
| 
 }; // not implemented  | 
|||
| 
 provide-ixfr boolean;  | 
|||
| 
 request-ixfr boolean;  | 
|||
| 
 rfc2308-type1 boolean; // not yet implemented  | 
|||
| 
 additional-from-auth boolean;  | 
|||
| 
 additional-from-cache boolean;  | 
|||
| 
 query-source querysource4;  | 
|||
| 
 query-source-v6 querysource6;  | 
|||
| 
 cleaning-interval integer;  | 
|||
| 
 min-roots integer; // not implemented  | 
|||
| 
 lame-ttl integer;  | 
|||
| 
 max-ncache-ttl integer;  | 
|||
| 
 max-cache-ttl integer;  | 
|||
| 
 transfer-format ( many-answers | one-answer );  | 
|||
| 
 max-cache-size size_no_default;  | 
|||
| 
 check-names ( master | slave | response )  | 
|||
| 
 ( fail | warn | ignore ); // not implemented  | |||
| 
 cache-file quoted_string;  | 
|||
| 
 root-delegation-only [ exclude { quoted_string; ... } ];  | 
|||
| 
 dialup dialuptype;  | 
|||
| 
 allow-query { address_match_element; ... };  | 
|||
| 
 allow-transfer { address_match_element; ... };  | 
|||
| 
 allow-update-forwarding { address_match_element; ... };  | 
|||
| 
 notify notifytype;  | 
|||
| 
 notify-source ( ipv4_address | * ) [ port ( integer | * ) ];  | 
|||
| 
 notify-source-v6 ( ipv6_address | * ) [ port ( integer | * ) ];  | 
|||
| 
 also-notify [ port integer ] { ( ipv4_address | ipv6_address )  | 
|||
| 
 [ port integer ]; ... };  | |||
| 
 allow-notify { address_match_element; ... };  | 
|||
| 
 forward ( first | only );  | 
|||
| 
 forwarders [ port integer ] {  | 
|||
| 
 ( ipv4_address | ipv6_address ) [ port integer ]; ...  | |||
| 
 };  | 
|||
| 
 max-transfer-time-in integer;  | 
|||
| 
 max-transfer-time-out integer;  | 
|||
| 
 max-transfer-idle-in integer;  | 
|||
| 
 max-transfer-idle-out integer;  | 
|||
| 
 max-retry-time integer;  | 
|||
| 
 min-retry-time integer;  | 
|||
| 
 max-refresh-time integer;  | 
|||
| 
 min-refresh-time integer;  | 
|||
| 
 sig-validity-interval integer;  | 
|||
| 
 transfer-source ( ipv4_address | * )  | 
|||
| 
 [ port ( integer | * ) ];  | |||
| 
 transfer-source-v6 ( ipv6_address | * )  | 
|||
| 
 [ port ( integer | * ) ];  | |||
| 
 zone-statistics boolean;  | 
|||
| 
 allow-v6-synthesis { address_match_element; ... };  | 
|||
| 
 deallocate-on-exit boolean; // obsolete  | 
|||
| 
 fake-iquery boolean; // obsolete  | 
|||
| 
 fetch-glue boolean; // obsolete  | 
|||
| 
 has-old-clients boolean; // obsolete  | 
|||
| 
 maintain-ixfr-base boolean; // obsolete  | 
|||
| 
 max-ixfr-log-size size; // obsolete  | 
|||
| 
 multiple-cnames boolean; // obsolete  | 
|||
| 
 named-xfer quoted_string; // obsolete  | 
|||
| 
 serial-queries integer; // obsolete  | 
|||
| 
 treat-cr-as-space boolean; // obsolete  | 
|||
| 
 use-id-pool boolean; // obsolete  | 
};
VIEW
view string optional_class {
| 
 match-clients { address_match_element; ... };  | 
|||
| 
 match-destinations { address_match_element; ... };  | 
|||
| 
 match-recursive-only boolean;  | 
|||
| 
 key string {  | 
|||
| 
 algorithm string;  | |||
| 
 secret string;  | |||
| 
 };  | 
|||
| 
 zone string optional_class {  | 
|||
| 
 ...  | |||
| 
 };  | 
|||
| 
 server ( ipv4_address | ipv6_address ) {  | 
|||
| 
 ...  | |||
| 
 };  | 
|||
| 
 trusted-keys {  | 
|||
| 
 string integer integer integer quoted_string; ...  | |||
| 
 };  | 
|||
| 
 allow-recursion { address_match_element; ... };  | 
|||
| 
 sortlist { address_match_element; ... };  | 
|||
| 
 topology { address_match_element; ... }; // not implemented  | 
|||
| 
 auth-nxdomain boolean; // default changed  | 
|||
| 
 minimal-responses boolean;  | 
|||
| 
 recursion boolean;  | 
|||
| 
 rrset-order {  | 
|||
| 
 [ class string ] [ type string ]  | |||
| 
 [ name quoted_string ] string string; ...  | |||
| 
 }; // not implemented  | 
|||
| 
 provide-ixfr boolean;  | 
|||
| 
 request-ixfr boolean;  | 
|||
| 
 rfc2308-type1 boolean; // not yet implemented  | 
|||
| 
 additional-from-auth boolean;  | 
|||
| 
 additional-from-cache boolean;  | 
|||
| 
 query-source querysource4;  | 
|||
| 
 query-source-v6 querysource6;  | 
|||
| 
 cleaning-interval integer;  | 
|||
| 
 min-roots integer; // not implemented  | 
|||
| 
 lame-ttl integer;  | 
|||
| 
 max-ncache-ttl integer;  | 
|||
| 
 max-cache-ttl integer;  | 
|||
| 
 transfer-format ( many-answers | one-answer );  | 
|||
| 
 max-cache-size size_no_default;  | 
|||
| 
 check-names ( master | slave | response )  | 
|||
| 
 ( fail | warn | ignore );  | |||
| 
 cache-file quoted_string;  | 
|||
| 
 suppress-initial-notify boolean; // not yet implemented  | 
|||
| 
 root-delegation-only [ exclude { quoted_string; ... } ];  | 
|||
| 
 dialup dialuptype;  | 
|||
| 
 allow-query { address_match_element; ... };  | 
|||
| 
 allow-transfer { address_match_element; ... };  | 
|||
| 
 allow-update-forwarding { address_match_element; ... };  | 
|||
| 
 notify notifytype;  | 
|||
| 
 notify-source ( ipv4_address | * ) [ port ( integer | * ) ];  | 
|||
| 
 notify-source-v6 ( ipv6_address | * ) [ port ( integer | * ) ];  | 
|||
| 
 also-notify [ port integer ] { ( ipv4_address | ipv6_address )  | 
|||
| 
 [ port integer ]; ... };  | |||
| 
 allow-notify { address_match_element; ... };  | 
|||
| 
 forward ( first | only );  | 
|||
| 
 forwarders [ port integer ] {  | 
|||
| 
 ( ipv4_address | ipv6_address ) [ port integer ]; ...  | |||
| 
 };  | 
|||
| 
 max-transfer-time-in integer;  | 
|||
| 
 max-transfer-time-out integer;  | 
|||
| 
 max-transfer-idle-in integer;  | 
|||
| 
 max-transfer-idle-out integer;  | 
|||
| 
 max-retry-time integer;  | 
|||
| 
 min-retry-time integer;  | 
|||
| 
 max-refresh-time integer;  | 
|||
| 
 min-refresh-time integer;  | 
|||
| 
 sig-validity-interval integer;  | 
|||
| 
 transfer-source ( ipv4_address | * )  | 
|||
| 
 [ port ( integer | * ) ];  | |||
| 
 transfer-source-v6 ( ipv6_address | * )  | 
|||
| 
 [ port ( integer | * ) ];  | |||
| 
 zone-statistics boolean;  | 
|||
| 
 allow-v6-synthesis { address_match_element; ... }; // obsolete  | 
|||
| 
 fetch-glue boolean; // obsolete  | 
|||
| 
 maintain-ixfr-base boolean; // obsolete  | 
|||
| 
 max-ixfr-log-size size; // obsolete  | 
};
ZONE
zone string optional_class {
| 
 type ( master | slave | stub | hint |  | 
|||
| 
 forward | delegation-only );  | |||
| 
 file quoted_string;  | 
|||
| 
 masters [ port integer ] {  | 
|||
| 
 ( ipv4_address [port integer] |  | |||
| 
 ipv6_address [ port integer ] ) [ key string ]; ...  | |||
| 
 };  | 
|||
| 
 database string;  | 
|||
| 
 delegation-only boolean;  | 
|||
| 
 check-names ( fail | warn | ignore );  | 
|||
| 
 dialup dialuptype;  | 
|||
| 
 allow-query { address_match_element; ... };  | 
|||
| 
 allow-transfer { address_match_element; ... };  | 
|||
| 
 allow-update { address_match_element; ... };  | 
|||
| 
 allow-update-forwarding { address_match_element; ... };  | 
|||
| 
 update-policy {  | 
|||
| 
 ( grant | deny ) string  | |||
| 
 ( name | subdomain | wildcard | self ) string  | |||
| 
 rrtypelist; ...  | |||
| 
 };  | 
|||
| 
 notify notifytype;  | 
|||
| 
 notify-source ( ipv4_address | * ) [ port ( integer | * ) ];  | 
|||
| 
 notify-source-v6 ( ipv6_address | * ) [ port ( integer | * ) ];  | 
|||
| 
 also-notify [ port integer ] { ( ipv4_address | ipv6_address )  | 
|||
| 
 [ port integer ]; ... };  | |||
| 
 allow-notify { address_match_element; ... };  | 
|||
| 
 forward ( first | only );  | 
|||
| 
 forwarders [ port integer ] {  | 
|||
| 
 ( ipv4_address | ipv6_address ) [ port integer ]; ...  | |||
| 
 };  | 
|||
| 
 max-transfer-time-in integer;  | 
|||
| 
 max-transfer-time-out integer;  | 
|||
| 
 max-transfer-idle-in integer;  | 
|||
| 
 max-transfer-idle-out integer;  | 
|||
| 
 max-retry-time integer;  | 
|||
| 
 min-retry-time integer;  | 
|||
| 
 max-refresh-time integer;  | 
|||
| 
 min-refresh-time integer;  | 
|||
| 
 sig-validity-interval integer;  | 
|||
| 
 transfer-source ( ipv4_address | * )  | 
|||
| 
 [ port ( integer | * ) ];  | |||
| 
 transfer-source-v6 ( ipv6_address | * )  | 
|||
| 
 [ port ( integer | * ) ];  | |||
| 
 zone-statistics boolean;  | 
|||
| 
 ixfr-base quoted_string; // obsolete  | 
|||
| 
 ixfr-tmp-file quoted_string; // obsolete  | 
|||
| 
 maintain-ixfr-base boolean; // obsolete  | 
|||
| 
 max-ixfr-log-size size; // obsolete  | 
|||
| 
 pubkey integer integer integer quoted_string; // obsolete  | 
};
FILES
/etc/named.conf
SEE ALSO
named(8), rndc(8), BIND 9 Adminstrators Reference Manual.