contrib/bind9/bin/named/named.conf.5

   1 .\" Copyright (C) 2004-2011, 2013 Internet Systems Consortium, Inc. ("ISC")
   2 .\"
   3 .\" Permission to use, copy, modify, and/or distribute this software for any
   4 .\" purpose with or without fee is hereby granted, provided that the above
   5 .\" copyright notice and this permission notice appear in all copies.
   6 .\"
   7 .\" THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
   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,
  10 .\" INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
  11 .\" LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
  12 .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  13 .\" PERFORMANCE OF THIS SOFTWARE.
  14 .\"
  15 .\" $Id$
  16 .\"
  17 .hy 0
  18 .ad l
  19 .\"     Title: \fInamed.conf\fR
  20 .\"    Author:
  21 .\" Generator: DocBook XSL Stylesheets v1.71.1 <http://docbook.sf.net/>
  22 .\"      Date: Aug 13, 2004
  23 .\"    Manual: BIND9
  24 .\"    Source: BIND9
  25 .\"
  26 .TH "\fINAMED.CONF\fR" "5" "Aug 13, 2004" "BIND9" "BIND9"
  27 .\" disable hyphenation
  28 .nh
  29 .\" disable justification (adjust text to left margin only)
  30 .ad l
  31 .SH "NAME"
  32 named.conf \- configuration file for named
  33 .SH "SYNOPSIS"
  34 .HP 11
  35 \fBnamed.conf\fR
  36 .SH "DESCRIPTION"
  37 .PP
  38 \fInamed.conf\fR
  39 is the configuration file for
  40 \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:
  41 .PP
  42 C style: /* */
  43 .PP
  44 C++ style: // to end of line
  45 .PP
  46 Unix style: # to end of line
  47 .SH "ACL"
  48 .sp
  49 .RS 4
  50 .nf
  51 acl \fIstring\fR { \fIaddress_match_element\fR; ... };
  52 .fi
  53 .RE
  54 .SH "KEY"
  55 .sp
  56 .RS 4
  57 .nf
  58 key \fIdomain_name\fR {
  59         algorithm \fIstring\fR;
  60         secret \fIstring\fR;
  61 };
  62 .fi
  63 .RE
  64 .SH "MASTERS"
  65 .sp
  66 .RS 4
  67 .nf
  68 masters \fIstring\fR [ port \fIinteger\fR ] {
  69         ( \fImasters\fR | \fIipv4_address\fR [port \fIinteger\fR] |
  70         \fIipv6_address\fR [port \fIinteger\fR] ) [ key \fIstring\fR ]; ...
  71 };
  72 .fi
  73 .RE
  74 .SH "SERVER"
  75 .sp
  76 .RS 4
  77 .nf
  78 server ( \fIipv4_address\fR\fI[/prefixlen]\fR | \fIipv6_address\fR\fI[/prefixlen]\fR ) {
  79         bogus \fIboolean\fR;
  80         edns \fIboolean\fR;
  81         edns\-udp\-size \fIinteger\fR;
  82         max\-udp\-size \fIinteger\fR;
  83         provide\-ixfr \fIboolean\fR;
  84         request\-ixfr \fIboolean\fR;
  85         keys \fIserver_key\fR;
  86         transfers \fIinteger\fR;
  87         transfer\-format ( many\-answers | one\-answer );
  88         transfer\-source ( \fIipv4_address\fR | * )
  89                 [ port ( \fIinteger\fR | * ) ];
  90         transfer\-source\-v6 ( \fIipv6_address\fR | * )
  91                 [ port ( \fIinteger\fR | * ) ];
  92         support\-ixfr \fIboolean\fR; // obsolete
  93 };
  94 .fi
  95 .RE
  96 .SH "TRUSTED\-KEYS"
  97 .sp
  98 .RS 4
  99 .nf
 100 trusted\-keys {
 101         \fIdomain_name\fR \fIflags\fR \fIprotocol\fR \fIalgorithm\fR \fIkey\fR; ...
 102 };
 103 .fi
 104 .RE
 105 .SH "MANAGED\-KEYS"
 106 .sp
 107 .RS 4
 108 .nf
 109 managed\-keys {
 110         \fIdomain_name\fR \fBinitial\-key\fR \fIflags\fR \fIprotocol\fR \fIalgorithm\fR \fIkey\fR; ...
 111 };
 112 .fi
 113 .RE
 114 .SH "CONTROLS"
 115 .sp
 116 .RS 4
 117 .nf
 118 controls {
 119         inet ( \fIipv4_address\fR | \fIipv6_address\fR | * )
 120                 [ port ( \fIinteger\fR | * ) ]
 121                 allow { \fIaddress_match_element\fR; ... }
 122                 [ keys { \fIstring\fR; ... } ];
 123         unix \fIunsupported\fR; // not implemented
 124 };
 125 .fi
 126 .RE
 127 .SH "LOGGING"
 128 .sp
 129 .RS 4
 130 .nf
 131 logging {
 132         channel \fIstring\fR {
 133                 file \fIlog_file\fR;
 134                 syslog \fIoptional_facility\fR;
 135                 null;
 136                 stderr;
 137                 severity \fIlog_severity\fR;
 138                 print\-time \fIboolean\fR;
 139                 print\-severity \fIboolean\fR;
 140                 print\-category \fIboolean\fR;
 141         };
 142         category \fIstring\fR { \fIstring\fR; ... };
 143 };
 144 .fi
 145 .RE
 146 .SH "LWRES"
 147 .sp
 148 .RS 4
 149 .nf
 150 lwres {
 151         listen\-on [ port \fIinteger\fR ] {
 152                 ( \fIipv4_address\fR | \fIipv6_address\fR ) [ port \fIinteger\fR ]; ...
 153         };
 154         view \fIstring\fR \fIoptional_class\fR;
 155         search { \fIstring\fR; ... };
 156         ndots \fIinteger\fR;
 157 };
 158 .fi
 159 .RE
 160 .SH "OPTIONS"
 161 .sp
 162 .RS 4
 163 .nf
 164 options {
 165         avoid\-v4\-udp\-ports { \fIport\fR; ... };
 166         avoid\-v6\-udp\-ports { \fIport\fR; ... };
 167         blackhole { \fIaddress_match_element\fR; ... };
 168         coresize \fIsize\fR;
 169         datasize \fIsize\fR;
 170         directory \fIquoted_string\fR;
 171         dump\-file \fIquoted_string\fR;
 172         files \fIsize\fR;
 173         heartbeat\-interval \fIinteger\fR;
 174         host\-statistics \fIboolean\fR; // not implemented
 175         host\-statistics\-max \fInumber\fR; // not implemented
 176         hostname ( \fIquoted_string\fR | none );
 177         interface\-interval \fIinteger\fR;
 178         listen\-on [ port \fIinteger\fR ] { \fIaddress_match_element\fR; ... };
 179         listen\-on\-v6 [ port \fIinteger\fR ] { \fIaddress_match_element\fR; ... };
 180         match\-mapped\-addresses \fIboolean\fR;
 181         memstatistics\-file \fIquoted_string\fR;
 182         pid\-file ( \fIquoted_string\fR | none );
 183         port \fIinteger\fR;
 184         querylog \fIboolean\fR;
 185         recursing\-file \fIquoted_string\fR;
 186         reserved\-sockets \fIinteger\fR;
 187         random\-device \fIquoted_string\fR;
 188         recursive\-clients \fIinteger\fR;
 189         serial\-query\-rate \fIinteger\fR;
 190         server\-id ( \fIquoted_string\fR | none );
 191         stacksize \fIsize\fR;
 192         statistics\-file \fIquoted_string\fR;
 193         statistics\-interval \fIinteger\fR; // not yet implemented
 194         tcp\-clients \fIinteger\fR;
 195         tcp\-listen\-queue \fIinteger\fR;
 196         tkey\-dhkey \fIquoted_string\fR \fIinteger\fR;
 197         tkey\-gssapi\-credential \fIquoted_string\fR;
 198         tkey\-gssapi\-keytab \fIquoted_string\fR;
 199         tkey\-domain \fIquoted_string\fR;
 200         transfers\-per\-ns \fIinteger\fR;
 201         transfers\-in \fIinteger\fR;
 202         transfers\-out \fIinteger\fR;
 203         use\-ixfr \fIboolean\fR;
 204         version ( \fIquoted_string\fR | none );
 205         allow\-recursion { \fIaddress_match_element\fR; ... };
 206         allow\-recursion\-on { \fIaddress_match_element\fR; ... };
 207         sortlist { \fIaddress_match_element\fR; ... };
 208         topology { \fIaddress_match_element\fR; ... }; // not implemented
 209         auth\-nxdomain \fIboolean\fR; // default changed
 210         minimal\-responses \fIboolean\fR;
 211         recursion \fIboolean\fR;
 212         rrset\-order {
 213                 [ class \fIstring\fR ] [ type \fIstring\fR ]
 214                 [ name \fIquoted_string\fR ] \fIstring\fR \fIstring\fR; ...
 215         };
 216         provide\-ixfr \fIboolean\fR;
 217         request\-ixfr \fIboolean\fR;
 218         rfc2308\-type1 \fIboolean\fR; // not yet implemented
 219         additional\-from\-auth \fIboolean\fR;
 220         additional\-from\-cache \fIboolean\fR;
 221         query\-source ( ( \fIipv4_address\fR | * ) | [ address ( \fIipv4_address\fR | * ) ] ) [ port ( \fIinteger\fR | * ) ];
 222         query\-source\-v6 ( ( \fIipv6_address\fR | * ) | [ address ( \fIipv6_address\fR | * ) ] ) [ port ( \fIinteger\fR | * ) ];
 223         use\-queryport\-pool \fIboolean\fR;
 224         queryport\-pool\-ports \fIinteger\fR;
 225         queryport\-pool\-updateinterval \fIinteger\fR;
 226         cleaning\-interval \fIinteger\fR;
 227         resolver\-query\-timeout \fIinteger\fR;
 228         min\-roots \fIinteger\fR; // not implemented
 229         lame\-ttl \fIinteger\fR;
 230         max\-ncache\-ttl \fIinteger\fR;
 231         max\-cache\-ttl \fIinteger\fR;
 232         transfer\-format ( many\-answers | one\-answer );
 233         max\-cache\-size \fIsize\fR;
 234         max\-acache\-size \fIsize\fR;
 235         clients\-per\-query \fInumber\fR;
 236         max\-clients\-per\-query \fInumber\fR;
 237         check\-names ( master | slave | response )
 238                 ( fail | warn | ignore );
 239         check\-mx ( fail | warn | ignore );
 240         check\-integrity \fIboolean\fR;
 241         check\-mx\-cname ( fail | warn | ignore );
 242         check\-srv\-cname ( fail | warn | ignore );
 243         cache\-file \fIquoted_string\fR; // test option
 244         suppress\-initial\-notify \fIboolean\fR; // not yet implemented
 245         preferred\-glue \fIstring\fR;
 246         dual\-stack\-servers [ port \fIinteger\fR ] {
 247                 ( \fIquoted_string\fR [port \fIinteger\fR] |
 248                 \fIipv4_address\fR [port \fIinteger\fR] |
 249                 \fIipv6_address\fR [port \fIinteger\fR] ); ...
 250         };
 251         edns\-udp\-size \fIinteger\fR;
 252         max\-udp\-size \fIinteger\fR;
 253         root\-delegation\-only [ exclude { \fIquoted_string\fR; ... } ];
 254         disable\-algorithms \fIstring\fR { \fIstring\fR; ... };
 255         dnssec\-enable \fIboolean\fR;
 256         dnssec\-validation \fIboolean\fR;
 257         dnssec\-lookaside ( \fIauto\fR | \fIno\fR | \fIdomain\fR trust\-anchor \fIdomain\fR );
 258         dnssec\-must\-be\-secure \fIstring\fR \fIboolean\fR;
 259         dnssec\-accept\-expired \fIboolean\fR;
 260         dns64\-server \fIstring\fR;
 261         dns64\-contact \fIstring\fR;
 262         dns64 \fIprefix\fR {
 263                 clients { <replacable>acl</replacable>; };
 264                 exclude { <replacable>acl</replacable>; };
 265                 mapped { <replacable>acl</replacable>; };
 266                 break\-dnssec \fIboolean\fR;
 267                 recursive\-only \fIboolean\fR;
 268                 suffix \fIipv6_address\fR;
 269         };
 270         empty\-server \fIstring\fR;
 271         empty\-contact \fIstring\fR;
 272         empty\-zones\-enable \fIboolean\fR;
 273         disable\-empty\-zone \fIstring\fR;
 274         dialup \fIdialuptype\fR;
 275         ixfr\-from\-differences \fIixfrdiff\fR;
 276         allow\-query { \fIaddress_match_element\fR; ... };
 277         allow\-query\-on { \fIaddress_match_element\fR; ... };
 278         allow\-query\-cache { \fIaddress_match_element\fR; ... };
 279         allow\-query\-cache\-on { \fIaddress_match_element\fR; ... };
 280         allow\-transfer { \fIaddress_match_element\fR; ... };
 281         allow\-update { \fIaddress_match_element\fR; ... };
 282         allow\-update\-forwarding { \fIaddress_match_element\fR; ... };
 283         update\-check\-ksk \fIboolean\fR;
 284         dnssec\-dnskey\-kskonly \fIboolean\fR;
 285         masterfile\-format ( text | raw );
 286         notify \fInotifytype\fR;
 287         notify\-source ( \fIipv4_address\fR | * ) [ port ( \fIinteger\fR | * ) ];
 288         notify\-source\-v6 ( \fIipv6_address\fR | * ) [ port ( \fIinteger\fR | * ) ];
 289         notify\-delay \fIseconds\fR;
 290         notify\-to\-soa \fIboolean\fR;
 291         also\-notify [ port \fIinteger\fR ] { ( \fIipv4_address\fR | \fIipv6_address\fR )
 292                 [ port \fIinteger\fR ]; ...
 293                 [ key \fIkeyname\fR ] ... };
 294         allow\-notify { \fIaddress_match_element\fR; ... };
 295         forward ( first | only );
 296         forwarders [ port \fIinteger\fR ] {
 297                 ( \fIipv4_address\fR | \fIipv6_address\fR ) [ port \fIinteger\fR ]; ...
 298         };
 299         max\-journal\-size \fIsize_no_default\fR;
 300         max\-transfer\-time\-in \fIinteger\fR;
 301         max\-transfer\-time\-out \fIinteger\fR;
 302         max\-transfer\-idle\-in \fIinteger\fR;
 303         max\-transfer\-idle\-out \fIinteger\fR;
 304         max\-retry\-time \fIinteger\fR;
 305         min\-retry\-time \fIinteger\fR;
 306         max\-refresh\-time \fIinteger\fR;
 307         min\-refresh\-time \fIinteger\fR;
 308         multi\-master \fIboolean\fR;
 309         sig\-validity\-interval \fIinteger\fR;
 310         sig\-re\-signing\-interval \fIinteger\fR;
 311         sig\-signing\-nodes \fIinteger\fR;
 312         sig\-signing\-signatures \fIinteger\fR;
 313         sig\-signing\-type \fIinteger\fR;
 314         transfer\-source ( \fIipv4_address\fR | * )
 315                 [ port ( \fIinteger\fR | * ) ];
 316         transfer\-source\-v6 ( \fIipv6_address\fR | * )
 317                 [ port ( \fIinteger\fR | * ) ];
 318         alt\-transfer\-source ( \fIipv4_address\fR | * )
 319                 [ port ( \fIinteger\fR | * ) ];
 320         alt\-transfer\-source\-v6 ( \fIipv6_address\fR | * )
 321                 [ port ( \fIinteger\fR | * ) ];
 322         use\-alt\-transfer\-source \fIboolean\fR;
 323         zone\-statistics \fIboolean\fR;
 324         key\-directory \fIquoted_string\fR;
 325         managed\-keys\-directory \fIquoted_string\fR;
 326         auto\-dnssec \fBallow\fR|\fBmaintain\fR|\fBcreate\fR|\fBoff\fR;
 327         try\-tcp\-refresh \fIboolean\fR;
 328         zero\-no\-soa\-ttl \fIboolean\fR;
 329         zero\-no\-soa\-ttl\-cache \fIboolean\fR;
 330         dnssec\-secure\-to\-insecure \fIboolean\fR;
 331         deny\-answer\-addresses {
 332                 \fIaddress_match_list\fR
 333         } [ except\-from { \fInamelist\fR } ];
 334         deny\-answer\-aliases {
 335                 \fInamelist\fR
 336         } [ except\-from { \fInamelist\fR } ];
 337         nsec3\-test\-zone \fIboolean\fR;  // testing only
 338         allow\-v6\-synthesis { \fIaddress_match_element\fR; ... }; // obsolete
 339         deallocate\-on\-exit \fIboolean\fR; // obsolete
 340         fake\-iquery \fIboolean\fR; // obsolete
 341         fetch\-glue \fIboolean\fR; // obsolete
 342         has\-old\-clients \fIboolean\fR; // obsolete
 343         maintain\-ixfr\-base \fIboolean\fR; // obsolete
 344         max\-ixfr\-log\-size \fIsize\fR; // obsolete
 345         multiple\-cnames \fIboolean\fR; // obsolete
 346         named\-xfer \fIquoted_string\fR; // obsolete
 347         serial\-queries \fIinteger\fR; // obsolete
 348         treat\-cr\-as\-space \fIboolean\fR; // obsolete
 349         use\-id\-pool \fIboolean\fR; // obsolete
 350 };
 351 .fi
 352 .RE
 353 .SH "VIEW"
 354 .sp
 355 .RS 4
 356 .nf
 357 view \fIstring\fR \fIoptional_class\fR {
 358         match\-clients { \fIaddress_match_element\fR; ... };
 359         match\-destinations { \fIaddress_match_element\fR; ... };
 360         match\-recursive\-only \fIboolean\fR;
 361         key \fIstring\fR {
 362                 algorithm \fIstring\fR;
 363                 secret \fIstring\fR;
 364         };
 365         zone \fIstring\fR \fIoptional_class\fR {
 366                 ...
 367         };
 368         server ( \fIipv4_address\fR\fI[/prefixlen]\fR | \fIipv6_address\fR\fI[/prefixlen]\fR ) {
 369                 ...
 370         };
 371         trusted\-keys {
 372                 \fIstring\fR \fIinteger\fR \fIinteger\fR \fIinteger\fR \fIquoted_string\fR;
 373                 [...]
 374         };
 375         allow\-recursion { \fIaddress_match_element\fR; ... };
 376         allow\-recursion\-on { \fIaddress_match_element\fR; ... };
 377         sortlist { \fIaddress_match_element\fR; ... };
 378         topology { \fIaddress_match_element\fR; ... }; // not implemented
 379         auth\-nxdomain \fIboolean\fR; // default changed
 380         minimal\-responses \fIboolean\fR;
 381         recursion \fIboolean\fR;
 382         rrset\-order {
 383                 [ class \fIstring\fR ] [ type \fIstring\fR ]
 384                 [ name \fIquoted_string\fR ] \fIstring\fR \fIstring\fR; ...
 385         };
 386         provide\-ixfr \fIboolean\fR;
 387         request\-ixfr \fIboolean\fR;
 388         rfc2308\-type1 \fIboolean\fR; // not yet implemented
 389         additional\-from\-auth \fIboolean\fR;
 390         additional\-from\-cache \fIboolean\fR;
 391         query\-source ( ( \fIipv4_address\fR | * ) | [ address ( \fIipv4_address\fR | * ) ] ) [ port ( \fIinteger\fR | * ) ];
 392         query\-source\-v6 ( ( \fIipv6_address\fR | * ) | [ address ( \fIipv6_address\fR | * ) ] ) [ port ( \fIinteger\fR | * ) ];
 393         use\-queryport\-pool \fIboolean\fR;
 394         queryport\-pool\-ports \fIinteger\fR;
 395         queryport\-pool\-updateinterval \fIinteger\fR;
 396         cleaning\-interval \fIinteger\fR;
 397         resolver\-query\-timeout \fIinteger\fR;
 398         min\-roots \fIinteger\fR; // not implemented
 399         lame\-ttl \fIinteger\fR;
 400         max\-ncache\-ttl \fIinteger\fR;
 401         max\-cache\-ttl \fIinteger\fR;
 402         transfer\-format ( many\-answers | one\-answer );
 403         max\-cache\-size \fIsize\fR;
 404         max\-acache\-size \fIsize\fR;
 405         clients\-per\-query \fInumber\fR;
 406         max\-clients\-per\-query \fInumber\fR;
 407         check\-names ( master | slave | response )
 408                 ( fail | warn | ignore );
 409         check\-mx ( fail | warn | ignore );
 410         check\-integrity \fIboolean\fR;
 411         check\-mx\-cname ( fail | warn | ignore );
 412         check\-srv\-cname ( fail | warn | ignore );
 413         cache\-file \fIquoted_string\fR; // test option
 414         suppress\-initial\-notify \fIboolean\fR; // not yet implemented
 415         preferred\-glue \fIstring\fR;
 416         dual\-stack\-servers [ port \fIinteger\fR ] {
 417                 ( \fIquoted_string\fR [port \fIinteger\fR] |
 418                 \fIipv4_address\fR [port \fIinteger\fR] |
 419                 \fIipv6_address\fR [port \fIinteger\fR] ); ...
 420         };
 421         edns\-udp\-size \fIinteger\fR;
 422         max\-udp\-size \fIinteger\fR;
 423         root\-delegation\-only [ exclude { \fIquoted_string\fR; ... } ];
 424         disable\-algorithms \fIstring\fR { \fIstring\fR; ... };
 425         dnssec\-enable \fIboolean\fR;
 426         dnssec\-validation \fIboolean\fR;
 427         dnssec\-lookaside ( \fIauto\fR | \fIno\fR | \fIdomain\fR trust\-anchor \fIdomain\fR );
 428         dnssec\-must\-be\-secure \fIstring\fR \fIboolean\fR;
 429         dnssec\-accept\-expired \fIboolean\fR;
 430         dns64\-server \fIstring\fR;
 431         dns64\-contact \fIstring\fR;
 432         dns64 \fIprefix\fR {
 433                 clients { <replacable>acl</replacable>; };
 434                 exclude { <replacable>acl</replacable>; };
 435                 mapped { <replacable>acl</replacable>; };
 436                 break\-dnssec \fIboolean\fR;
 437                 recursive\-only \fIboolean\fR;
 438                 suffix \fIipv6_address\fR;
 439         };
 440         empty\-server \fIstring\fR;
 441         empty\-contact \fIstring\fR;
 442         empty\-zones\-enable \fIboolean\fR;
 443         disable\-empty\-zone \fIstring\fR;
 444         dialup \fIdialuptype\fR;
 445         ixfr\-from\-differences \fIixfrdiff\fR;
 446         allow\-query { \fIaddress_match_element\fR; ... };
 447         allow\-query\-on { \fIaddress_match_element\fR; ... };
 448         allow\-query\-cache { \fIaddress_match_element\fR; ... };
 449         allow\-query\-cache\-on { \fIaddress_match_element\fR; ... };
 450         allow\-transfer { \fIaddress_match_element\fR; ... };
 451         allow\-update { \fIaddress_match_element\fR; ... };
 452         allow\-update\-forwarding { \fIaddress_match_element\fR; ... };
 453         update\-check\-ksk \fIboolean\fR;
 454         dnssec\-dnskey\-kskonly \fIboolean\fR;
 455         masterfile\-format ( text | raw );
 456         notify \fInotifytype\fR;
 457         notify\-source ( \fIipv4_address\fR | * ) [ port ( \fIinteger\fR | * ) ];
 458         notify\-source\-v6 ( \fIipv6_address\fR | * ) [ port ( \fIinteger\fR | * ) ];
 459         notify\-delay \fIseconds\fR;
 460         notify\-to\-soa \fIboolean\fR;
 461         also\-notify [ port \fIinteger\fR ] { ( \fIipv4_address\fR | \fIipv6_address\fR )
 462                 [ port \fIinteger\fR ]; ...
 463                 [ key \fIkeyname\fR ] ... };
 464         allow\-notify { \fIaddress_match_element\fR; ... };
 465         forward ( first | only );
 466         forwarders [ port \fIinteger\fR ] {
 467                 ( \fIipv4_address\fR | \fIipv6_address\fR ) [ port \fIinteger\fR ]; ...
 468         };
 469         max\-journal\-size \fIsize_no_default\fR;
 470         max\-transfer\-time\-in \fIinteger\fR;
 471         max\-transfer\-time\-out \fIinteger\fR;
 472         max\-transfer\-idle\-in \fIinteger\fR;
 473         max\-transfer\-idle\-out \fIinteger\fR;
 474         max\-retry\-time \fIinteger\fR;
 475         min\-retry\-time \fIinteger\fR;
 476         max\-refresh\-time \fIinteger\fR;
 477         min\-refresh\-time \fIinteger\fR;
 478         multi\-master \fIboolean\fR;
 479         sig\-validity\-interval \fIinteger\fR;
 480         transfer\-source ( \fIipv4_address\fR | * )
 481                 [ port ( \fIinteger\fR | * ) ];
 482         transfer\-source\-v6 ( \fIipv6_address\fR | * )
 483                 [ port ( \fIinteger\fR | * ) ];
 484         alt\-transfer\-source ( \fIipv4_address\fR | * )
 485                 [ port ( \fIinteger\fR | * ) ];
 486         alt\-transfer\-source\-v6 ( \fIipv6_address\fR | * )
 487                 [ port ( \fIinteger\fR | * ) ];
 488         use\-alt\-transfer\-source \fIboolean\fR;
 489         zone\-statistics \fIboolean\fR;
 490         try\-tcp\-refresh \fIboolean\fR;
 491         key\-directory \fIquoted_string\fR;
 492         zero\-no\-soa\-ttl \fIboolean\fR;
 493         zero\-no\-soa\-ttl\-cache \fIboolean\fR;
 494         dnssec\-secure\-to\-insecure \fIboolean\fR;
 495         allow\-v6\-synthesis { \fIaddress_match_element\fR; ... }; // obsolete
 496         fetch\-glue \fIboolean\fR; // obsolete
 497         maintain\-ixfr\-base \fIboolean\fR; // obsolete
 498         max\-ixfr\-log\-size \fIsize\fR; // obsolete
 499 };
 500 .fi
 501 .RE
 502 .SH "ZONE"
 503 .sp
 504 .RS 4
 505 .nf
 506 zone \fIstring\fR \fIoptional_class\fR {
 507         type ( master | slave | stub | hint | redirect |
 508                 forward | delegation\-only );
 509         file \fIquoted_string\fR;
 510         masters [ port \fIinteger\fR ] {
 511                 ( \fImasters\fR |
 512                 \fIipv4_address\fR [port \fIinteger\fR] |
 513                 \fIipv6_address\fR [ port \fIinteger\fR ] ) [ key \fIstring\fR ]; ...
 514         };
 515         database \fIstring\fR;
 516         delegation\-only \fIboolean\fR;
 517         check\-names ( fail | warn | ignore );
 518         check\-mx ( fail | warn | ignore );
 519         check\-integrity \fIboolean\fR;
 520         check\-mx\-cname ( fail | warn | ignore );
 521         check\-srv\-cname ( fail | warn | ignore );
 522         dialup \fIdialuptype\fR;
 523         ixfr\-from\-differences \fIboolean\fR;
 524         journal \fIquoted_string\fR;
 525         zero\-no\-soa\-ttl \fIboolean\fR;
 526         dnssec\-secure\-to\-insecure \fIboolean\fR;
 527         allow\-query { \fIaddress_match_element\fR; ... };
 528         allow\-query\-on { \fIaddress_match_element\fR; ... };
 529         allow\-transfer { \fIaddress_match_element\fR; ... };
 530         allow\-update { \fIaddress_match_element\fR; ... };
 531         allow\-update\-forwarding { \fIaddress_match_element\fR; ... };
 532         update\-policy \fIlocal\fR | \fI {
 533                 ( grant | deny ) \fR\fI\fIstring\fR\fR\fI
 534                 ( name | subdomain | wildcard | self | selfsub | selfwild |
 535                   krb5\-self | ms\-self | krb5\-subdomain | ms\-subdomain |
 536                   tcp\-self | zonesub | 6to4\-self ) \fR\fI\fIstring\fR\fR\fI
 537                 \fR\fI\fIrrtypelist\fR\fR\fI;
 538                 \fR\fI[...]\fR\fI
 539         }\fR;
 540         update\-check\-ksk \fIboolean\fR;
 541         dnssec\-dnskey\-kskonly \fIboolean\fR;
 542         masterfile\-format ( text | raw );
 543         notify \fInotifytype\fR;
 544         notify\-source ( \fIipv4_address\fR | * ) [ port ( \fIinteger\fR | * ) ];
 545         notify\-source\-v6 ( \fIipv6_address\fR | * ) [ port ( \fIinteger\fR | * ) ];
 546         notify\-delay \fIseconds\fR;
 547         notify\-to\-soa \fIboolean\fR;
 548         also\-notify [ port \fIinteger\fR ] { ( \fIipv4_address\fR | \fIipv6_address\fR )
 549                 [ port \fIinteger\fR ]; ...
 550                 [ key \fIkeyname\fR ] ... };
 551         allow\-notify { \fIaddress_match_element\fR; ... };
 552         forward ( first | only );
 553         forwarders [ port \fIinteger\fR ] {
 554                 ( \fIipv4_address\fR | \fIipv6_address\fR ) [ port \fIinteger\fR ]; ...
 555         };
 556         max\-journal\-size \fIsize_no_default\fR;
 557         max\-transfer\-time\-in \fIinteger\fR;
 558         max\-transfer\-time\-out \fIinteger\fR;
 559         max\-transfer\-idle\-in \fIinteger\fR;
 560         max\-transfer\-idle\-out \fIinteger\fR;
 561         max\-retry\-time \fIinteger\fR;
 562         min\-retry\-time \fIinteger\fR;
 563         max\-refresh\-time \fIinteger\fR;
 564         min\-refresh\-time \fIinteger\fR;
 565         multi\-master \fIboolean\fR;
 566         request\-ixfr \fIboolean\fR;
 567         sig\-validity\-interval \fIinteger\fR;
 568         transfer\-source ( \fIipv4_address\fR | * )
 569                 [ port ( \fIinteger\fR | * ) ];
 570         transfer\-source\-v6 ( \fIipv6_address\fR | * )
 571                 [ port ( \fIinteger\fR | * ) ];
 572         alt\-transfer\-source ( \fIipv4_address\fR | * )
 573                 [ port ( \fIinteger\fR | * ) ];
 574         alt\-transfer\-source\-v6 ( \fIipv6_address\fR | * )
 575                 [ port ( \fIinteger\fR | * ) ];
 576         use\-alt\-transfer\-source \fIboolean\fR;
 577         zone\-statistics \fIboolean\fR;
 578         try\-tcp\-refresh \fIboolean\fR;
 579         key\-directory \fIquoted_string\fR;
 580         nsec3\-test\-zone \fIboolean\fR;  // testing only
 581         ixfr\-base \fIquoted_string\fR; // obsolete
 582         ixfr\-tmp\-file \fIquoted_string\fR; // obsolete
 583         maintain\-ixfr\-base \fIboolean\fR; // obsolete
 584         max\-ixfr\-log\-size \fIsize\fR; // obsolete
 585         pubkey \fIinteger\fR \fIinteger\fR \fIinteger\fR \fIquoted_string\fR; // obsolete
 586 };
 587 .fi
 588 .RE
 589 .SH "FILES"
 590 .PP
 591 \fI/etc/named.conf\fR
 592 .SH "SEE ALSO"
 593 .PP
 594 \fBnamed\fR(8),
 595 \fBnamed\-checkconf\fR(8),
 596 \fBrndc\fR(8),
 597 BIND 9 Administrator Reference Manual.
 598 .SH "COPYRIGHT"
 599 Copyright \(co 2004\-2011, 2013 Internet Systems Consortium, Inc. ("ISC")
 600 .br