2007-06-02 23:21:47 +00:00
<!--
- Copyright (C) 2004-2007 Internet Systems Consortium, Inc. ("ISC")
- Copyright (C) 2000-2003 Internet Software Consortium.
-
- Permission to use, copy, modify, and distribute this software for any
- purpose with or without fee is hereby granted, provided that the above
- copyright notice and this permission notice appear in all copies.
-
- THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
- REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
- AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
- INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
- LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
- OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
- PERFORMANCE OF THIS SOFTWARE.
-->
2007-12-02 19:10:41 +00:00
<!-- $Id: man.named - checkzone.html,v 1.2.2.52 2007/10/31 01:35:59 marka Exp $ -->
2007-06-02 23:21:47 +00:00
< html >
< head >
< meta http-equiv = "Content-Type" content = "text/html; charset=ISO-8859-1" >
< title > named-checkzone< / title >
< meta name = "generator" content = "DocBook XSL Stylesheets V1.71.1" >
< link rel = "start" href = "Bv9ARM.html" title = "BIND 9 Administrator Reference Manual" >
< link rel = "up" href = "Bv9ARM.ch10.html" title = "Manual pages" >
< link rel = "prev" href = "man.named-checkconf.html" title = "named-checkconf" >
< link rel = "next" href = "man.named.html" title = "named" >
< / head >
< body bgcolor = "white" text = "black" link = "#0000FF" vlink = "#840084" alink = "#0000FF" >
< div class = "navheader" >
< table width = "100%" summary = "Navigation header" >
< tr > < th colspan = "3" align = "center" > < span class = "application" > named-checkzone< / span > < / th > < / tr >
< tr >
< td width = "20%" align = "left" >
< a accesskey = "p" href = "man.named-checkconf.html" > Prev< / a > <EFBFBD> < / td >
< th width = "60%" align = "center" > Manual pages< / th >
< td width = "20%" align = "right" > <EFBFBD> < a accesskey = "n" href = "man.named.html" > Next< / a >
< / td >
< / tr >
< / table >
< hr >
< / div >
< div class = "refentry" lang = "en" >
< a name = "man.named-checkzone" > < / a > < div class = "titlepage" > < / div >
< div class = "refnamediv" >
< h2 > Name< / h2 >
< p > < span class = "application" > named-checkzone< / span > , < span class = "application" > named-compilezone< / span > — zone file validity checking or converting tool< / p >
< / div >
< div class = "refsynopsisdiv" >
< h2 > Synopsis< / h2 >
< div class = "cmdsynopsis" > < p > < code class = "command" > named-checkzone< / code > [< code class = "option" > -d< / code > ] [< code class = "option" > -j< / code > ] [< code class = "option" > -q< / code > ] [< code class = "option" > -v< / code > ] [< code class = "option" > -c < em class = "replaceable" > < code > class< / code > < / em > < / code > ] [< code class = "option" > -f < em class = "replaceable" > < code > format< / code > < / em > < / code > ] [< code class = "option" > -F < em class = "replaceable" > < code > format< / code > < / em > < / code > ] [< code class = "option" > -i < em class = "replaceable" > < code > mode< / code > < / em > < / code > ] [< code class = "option" > -k < em class = "replaceable" > < code > mode< / code > < / em > < / code > ] [< code class = "option" > -m < em class = "replaceable" > < code > mode< / code > < / em > < / code > ] [< code class = "option" > -M < em class = "replaceable" > < code > mode< / code > < / em > < / code > ] [< code class = "option" > -n < em class = "replaceable" > < code > mode< / code > < / em > < / code > ] [< code class = "option" > -o < em class = "replaceable" > < code > filename< / code > < / em > < / code > ] [< code class = "option" > -s < em class = "replaceable" > < code > style< / code > < / em > < / code > ] [< code class = "option" > -S < em class = "replaceable" > < code > mode< / code > < / em > < / code > ] [< code class = "option" > -t < em class = "replaceable" > < code > directory< / code > < / em > < / code > ] [< code class = "option" > -w < em class = "replaceable" > < code > directory< / code > < / em > < / code > ] [< code class = "option" > -D< / code > ] [< code class = "option" > -W < em class = "replaceable" > < code > mode< / code > < / em > < / code > ] {zonename} {filename}< / p > < / div >
< div class = "cmdsynopsis" > < p > < code class = "command" > named-compilezone< / code > [< code class = "option" > -d< / code > ] [< code class = "option" > -j< / code > ] [< code class = "option" > -q< / code > ] [< code class = "option" > -v< / code > ] [< code class = "option" > -c < em class = "replaceable" > < code > class< / code > < / em > < / code > ] [< code class = "option" > -C < em class = "replaceable" > < code > mode< / code > < / em > < / code > ] [< code class = "option" > -f < em class = "replaceable" > < code > format< / code > < / em > < / code > ] [< code class = "option" > -F < em class = "replaceable" > < code > format< / code > < / em > < / code > ] [< code class = "option" > -i < em class = "replaceable" > < code > mode< / code > < / em > < / code > ] [< code class = "option" > -k < em class = "replaceable" > < code > mode< / code > < / em > < / code > ] [< code class = "option" > -m < em class = "replaceable" > < code > mode< / code > < / em > < / code > ] [< code class = "option" > -n < em class = "replaceable" > < code > mode< / code > < / em > < / code > ] [< code class = "option" > -o < em class = "replaceable" > < code > filename< / code > < / em > < / code > ] [< code class = "option" > -s < em class = "replaceable" > < code > style< / code > < / em > < / code > ] [< code class = "option" > -t < em class = "replaceable" > < code > directory< / code > < / em > < / code > ] [< code class = "option" > -w < em class = "replaceable" > < code > directory< / code > < / em > < / code > ] [< code class = "option" > -D< / code > ] [< code class = "option" > -W < em class = "replaceable" > < code > mode< / code > < / em > < / code > ] {zonename} {filename}< / p > < / div >
< / div >
< div class = "refsect1" lang = "en" >
2007-12-02 19:10:41 +00:00
< a name = "id2600689" > < / a > < h2 > DESCRIPTION< / h2 >
2007-06-02 23:21:47 +00:00
< p > < span > < strong class = "command" > named-checkzone< / strong > < / span >
checks the syntax and integrity of a zone file. It performs the
same checks as < span > < strong class = "command" > named< / strong > < / span > does when loading a
zone. This makes < span > < strong class = "command" > named-checkzone< / strong > < / span > useful for
checking zone files before configuring them into a name server.
< / p >
< p >
< span > < strong class = "command" > named-compilezone< / strong > < / span > is similar to
< span > < strong class = "command" > named-checkzone< / strong > < / span > , but it always dumps the
zone contents to a specified file in a specified format.
Additionally, it applies stricter check levels by default,
since the dump output will be used as an actual zone file
loaded by < span > < strong class = "command" > named< / strong > < / span > .
2007-12-02 19:10:41 +00:00
When manually specified otherwise, the check levels must at
2007-06-02 23:21:47 +00:00
least be as strict as those specified in the
< span > < strong class = "command" > named< / strong > < / span > configuration file.
< / p >
< / div >
< div class = "refsect1" lang = "en" >
2007-12-02 19:10:41 +00:00
< a name = "id2600739" > < / a > < h2 > OPTIONS< / h2 >
2007-06-02 23:21:47 +00:00
< div class = "variablelist" > < dl >
< dt > < span class = "term" > -d< / span > < / dt >
< dd > < p >
Enable debugging.
< / p > < / dd >
< dt > < span class = "term" > -q< / span > < / dt >
< dd > < p >
Quiet mode - exit code only.
< / p > < / dd >
< dt > < span class = "term" > -v< / span > < / dt >
< dd > < p >
Print the version of the < span > < strong class = "command" > named-checkzone< / strong > < / span >
program and exit.
< / p > < / dd >
< dt > < span class = "term" > -j< / span > < / dt >
< dd > < p >
When loading the zone file read the journal if it exists.
< / p > < / dd >
< dt > < span class = "term" > -c < em class = "replaceable" > < code > class< / code > < / em > < / span > < / dt >
< dd > < p >
Specify the class of the zone. If not specified "IN" is assumed.
< / p > < / dd >
< dt > < span class = "term" > -i < em class = "replaceable" > < code > mode< / code > < / em > < / span > < / dt >
< dd >
< p >
2007-12-02 19:10:41 +00:00
Perform post-load zone integrity checks. Possible modes are
2007-06-02 23:21:47 +00:00
< span > < strong class = "command" > "full"< / strong > < / span > (default),
< span > < strong class = "command" > "full-sibling"< / strong > < / span > ,
< span > < strong class = "command" > "local"< / strong > < / span > ,
< span > < strong class = "command" > "local-sibling"< / strong > < / span > and
< span > < strong class = "command" > "none"< / strong > < / span > .
< / p >
< p >
Mode < span > < strong class = "command" > "full"< / strong > < / span > checks that MX records
refer to A or AAAA record (both in-zone and out-of-zone
hostnames). Mode < span > < strong class = "command" > "local"< / strong > < / span > only
checks MX records which refer to in-zone hostnames.
< / p >
< p >
Mode < span > < strong class = "command" > "full"< / strong > < / span > checks that SRV records
refer to A or AAAA record (both in-zone and out-of-zone
hostnames). Mode < span > < strong class = "command" > "local"< / strong > < / span > only
checks SRV records which refer to in-zone hostnames.
< / p >
< p >
Mode < span > < strong class = "command" > "full"< / strong > < / span > checks that delegation NS
records refer to A or AAAA record (both in-zone and out-of-zone
2007-12-02 19:10:41 +00:00
hostnames). It also checks that glue address records
2007-06-02 23:21:47 +00:00
in the zone match those advertised by the child.
Mode < span > < strong class = "command" > "local"< / strong > < / span > only checks NS records which
refer to in-zone hostnames or that some required glue exists,
that is when the nameserver is in a child zone.
< / p >
< p >
Mode < span > < strong class = "command" > "full-sibling"< / strong > < / span > and
< span > < strong class = "command" > "local-sibling"< / strong > < / span > disable sibling glue
checks but are otherwise the same as < span > < strong class = "command" > "full"< / strong > < / span >
and < span > < strong class = "command" > "local"< / strong > < / span > respectively.
< / p >
< p >
Mode < span > < strong class = "command" > "none"< / strong > < / span > disables the checks.
< / p >
< / dd >
< dt > < span class = "term" > -f < em class = "replaceable" > < code > format< / code > < / em > < / span > < / dt >
< dd > < p >
Specify the format of the zone file.
Possible formats are < span > < strong class = "command" > "text"< / strong > < / span > (default)
and < span > < strong class = "command" > "raw"< / strong > < / span > .
< / p > < / dd >
< dt > < span class = "term" > -F < em class = "replaceable" > < code > format< / code > < / em > < / span > < / dt >
< dd > < p >
Specify the format of the output file specified.
Possible formats are < span > < strong class = "command" > "text"< / strong > < / span > (default)
and < span > < strong class = "command" > "raw"< / strong > < / span > .
For < span > < strong class = "command" > named-checkzone< / strong > < / span > ,
this does not cause any effects unless it dumps the zone
contents.
< / p > < / dd >
< dt > < span class = "term" > -k < em class = "replaceable" > < code > mode< / code > < / em > < / span > < / dt >
< dd > < p >
Perform < span > < strong class = "command" > "check-names"< / strong > < / span > checks with the
specified failure mode.
Possible modes are < span > < strong class = "command" > "fail"< / strong > < / span >
(default for < span > < strong class = "command" > named-compilezone< / strong > < / span > ),
< span > < strong class = "command" > "warn"< / strong > < / span >
(default for < span > < strong class = "command" > named-checkzone< / strong > < / span > ) and
< span > < strong class = "command" > "ignore"< / strong > < / span > .
< / p > < / dd >
< dt > < span class = "term" > -m < em class = "replaceable" > < code > mode< / code > < / em > < / span > < / dt >
< dd > < p >
Specify whether MX records should be checked to see if they
are addresses. Possible modes are < span > < strong class = "command" > "fail"< / strong > < / span > ,
< span > < strong class = "command" > "warn"< / strong > < / span > (default) and
< span > < strong class = "command" > "ignore"< / strong > < / span > .
< / p > < / dd >
< dt > < span class = "term" > -M < em class = "replaceable" > < code > mode< / code > < / em > < / span > < / dt >
< dd > < p >
Check if a MX record refers to a CNAME.
Possible modes are < span > < strong class = "command" > "fail"< / strong > < / span > ,
< span > < strong class = "command" > "warn"< / strong > < / span > (default) and
< span > < strong class = "command" > "ignore"< / strong > < / span > .
< / p > < / dd >
< dt > < span class = "term" > -n < em class = "replaceable" > < code > mode< / code > < / em > < / span > < / dt >
< dd > < p >
Specify whether NS records should be checked to see if they
are addresses.
Possible modes are < span > < strong class = "command" > "fail"< / strong > < / span >
(default for < span > < strong class = "command" > named-compilezone< / strong > < / span > ),
< span > < strong class = "command" > "warn"< / strong > < / span >
(default for < span > < strong class = "command" > named-checkzone< / strong > < / span > ) and
< span > < strong class = "command" > "ignore"< / strong > < / span > .
< / p > < / dd >
< dt > < span class = "term" > -o < em class = "replaceable" > < code > filename< / code > < / em > < / span > < / dt >
< dd > < p >
Write zone output to < code class = "filename" > filename< / code > .
This is mandatory for < span > < strong class = "command" > named-compilezone< / strong > < / span > .
< / p > < / dd >
< dt > < span class = "term" > -s < em class = "replaceable" > < code > style< / code > < / em > < / span > < / dt >
< dd > < p >
Specify the style of the dumped zone file.
Possible styles are < span > < strong class = "command" > "full"< / strong > < / span > (default)
and < span > < strong class = "command" > "relative"< / strong > < / span > .
The full format is most suitable for processing
automatically by a separate script.
On the other hand, the relative format is more
human-readable and is thus suitable for editing by hand.
For < span > < strong class = "command" > named-checkzone< / strong > < / span >
this does not cause any effects unless it dumps the zone
contents.
It also does not have any meaning if the output format
is not text.
< / p > < / dd >
< dt > < span class = "term" > -S < em class = "replaceable" > < code > mode< / code > < / em > < / span > < / dt >
< dd > < p >
Check if a SRV record refers to a CNAME.
Possible modes are < span > < strong class = "command" > "fail"< / strong > < / span > ,
< span > < strong class = "command" > "warn"< / strong > < / span > (default) and
< span > < strong class = "command" > "ignore"< / strong > < / span > .
< / p > < / dd >
< dt > < span class = "term" > -t < em class = "replaceable" > < code > directory< / code > < / em > < / span > < / dt >
< dd > < p >
2007-12-02 19:10:41 +00:00
Chroot to < code class = "filename" > directory< / code > so that
2007-06-02 23:21:47 +00:00
include
directives in the configuration file are processed as if
run by a similarly chrooted named.
< / p > < / dd >
< dt > < span class = "term" > -w < em class = "replaceable" > < code > directory< / code > < / em > < / span > < / dt >
< dd > < p >
chdir to < code class = "filename" > directory< / code > so that
relative
filenames in master file $INCLUDE directives work. This
is similar to the directory clause in
< code class = "filename" > named.conf< / code > .
< / p > < / dd >
< dt > < span class = "term" > -D< / span > < / dt >
< dd > < p >
Dump zone file in canonical format.
This is always enabled for < span > < strong class = "command" > named-compilezone< / strong > < / span > .
< / p > < / dd >
< dt > < span class = "term" > -W < em class = "replaceable" > < code > mode< / code > < / em > < / span > < / dt >
< dd > < p >
Specify whether to check for non-terminal wildcards.
Non-terminal wildcards are almost always the result of a
failure to understand the wildcard matching algorithm (RFC 1034).
Possible modes are < span > < strong class = "command" > "warn"< / strong > < / span > (default)
and
< span > < strong class = "command" > "ignore"< / strong > < / span > .
< / p > < / dd >
< dt > < span class = "term" > zonename< / span > < / dt >
< dd > < p >
The domain name of the zone being checked.
< / p > < / dd >
< dt > < span class = "term" > filename< / span > < / dt >
< dd > < p >
The name of the zone file.
< / p > < / dd >
< / dl > < / div >
< / div >
< div class = "refsect1" lang = "en" >
2007-12-02 19:10:41 +00:00
< a name = "id2655177" > < / a > < h2 > RETURN VALUES< / h2 >
2007-06-02 23:21:47 +00:00
< p > < span > < strong class = "command" > named-checkzone< / strong > < / span >
returns an exit status of 1 if
errors were detected and 0 otherwise.
< / p >
< / div >
< div class = "refsect1" lang = "en" >
2007-12-02 19:10:41 +00:00
< a name = "id2655191" > < / a > < h2 > SEE ALSO< / h2 >
2007-06-02 23:21:47 +00:00
< p > < span class = "citerefentry" > < span class = "refentrytitle" > named< / span > (8)< / span > ,
2007-12-02 19:10:41 +00:00
< span class = "citerefentry" > < span class = "refentrytitle" > named-checkconf< / span > (8)< / span > ,
2007-06-02 23:21:47 +00:00
< em class = "citetitle" > RFC 1035< / em > ,
< em class = "citetitle" > BIND 9 Administrator Reference Manual< / em > .
< / p >
< / div >
< div class = "refsect1" lang = "en" >
2007-12-02 19:10:41 +00:00
< a name = "id2655224" > < / a > < h2 > AUTHOR< / h2 >
2007-06-02 23:21:47 +00:00
< p > < span class = "corpauthor" > Internet Systems Consortium< / span >
< / p >
< / div >
< / div >
< div class = "navfooter" >
< hr >
< table width = "100%" summary = "Navigation footer" >
< tr >
< td width = "40%" align = "left" >
< a accesskey = "p" href = "man.named-checkconf.html" > Prev< / a > <EFBFBD> < / td >
< td width = "20%" align = "center" > < a accesskey = "u" href = "Bv9ARM.ch10.html" > Up< / a > < / td >
< td width = "40%" align = "right" > <EFBFBD> < a accesskey = "n" href = "man.named.html" > Next< / a >
< / td >
< / tr >
< tr >
< td width = "40%" align = "left" valign = "top" >
< span class = "application" > named-checkconf< / span > <EFBFBD> < / td >
< td width = "20%" align = "center" > < a accesskey = "h" href = "Bv9ARM.html" > Home< / a > < / td >
< td width = "40%" align = "right" valign = "top" > <EFBFBD> < span class = "application" > named< / span >
< / td >
< / tr >
< / table >
< / div >
< / body >
< / html >
