2004-09-18 21:30:24 -04:00
<!--
2009-05-30 20:11:36 -04:00
- Copyright (C) 2004-2007, 2009 Internet Systems Consortium, Inc. ("ISC")
2005-12-28 23:22:58 -05:00
- Copyright (C) 2000-2002 Internet Software Consortium.
-
2004-09-18 21:30:24 -04:00
- 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.
2005-12-28 23:22:58 -05:00
-
2004-09-18 21:30:24 -04:00
- THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
- REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
2005-12-28 23:22:58 -05:00
- AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
2004-09-18 21:30:24 -04:00
- 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.
-->
2009-05-30 20:11:36 -04:00
<!-- $Id: named - checkzone.html,v 1.42.334.1 2009/01/23 01:53:33 tbox Exp $ -->
2005-12-28 23:22:58 -05:00
< html >
< head >
< meta http-equiv = "Content-Type" content = "text/html; charset=ISO-8859-1" >
< title > named-checkzone< / title >
2007-06-02 19:21:47 -04:00
< meta name = "generator" content = "DocBook XSL Stylesheets V1.71.1" >
2005-12-28 23:22:58 -05:00
< / head >
< body bgcolor = "white" text = "black" link = "#0000FF" vlink = "#840084" alink = "#0000FF" > < div class = "refentry" lang = "en" >
2007-06-02 19:21:47 -04:00
< a name = "man.named-checkzone" > < / a > < div class = "titlepage" > < / div >
2005-12-28 23:22:58 -05:00
< div class = "refnamediv" >
< h2 > Name< / h2 >
2007-06-02 19:21:47 -04:00
< p > < span class = "application" > named-checkzone< / span > , < span class = "application" > named-compilezone< / span > — zone file validity checking or converting tool< / p >
2005-12-28 23:22:58 -05:00
< / div >
< div class = "refsynopsisdiv" >
< h2 > Synopsis< / h2 >
2009-05-30 20:11:36 -04:00
< div class = "cmdsynopsis" > < p > < code class = "command" > named-checkzone< / code > [< code class = "option" > -d< / code > ] [< code class = "option" > -h< / 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 >
2007-06-02 19:21:47 -04:00
< 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 >
2005-12-28 23:22:58 -05:00
< / div >
< div class = "refsect1" lang = "en" >
2009-05-30 20:11:36 -04:00
< a name = "id2543672" > < / a > < h2 > DESCRIPTION< / h2 >
2007-06-02 19:21:47 -04: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.
2005-12-28 23:22:58 -05:00
< / p >
2007-06-02 19:21:47 -04:00
< 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 14:10:41 -05:00
When manually specified otherwise, the check levels must at
2007-06-02 19:21:47 -04:00
least be as strict as those specified in the
< span > < strong class = "command" > named< / strong > < / span > configuration file.
< / p >
2005-12-28 23:22:58 -05:00
< / div >
< div class = "refsect1" lang = "en" >
2009-05-30 20:11:36 -04:00
< a name = "id2543707" > < / a > < h2 > OPTIONS< / h2 >
2005-12-28 23:22:58 -05:00
< div class = "variablelist" > < dl >
< dt > < span class = "term" > -d< / span > < / dt >
< dd > < p >
2007-06-02 19:21:47 -04:00
Enable debugging.
< / p > < / dd >
2009-05-30 20:11:36 -04:00
< dt > < span class = "term" > -h< / span > < / dt >
< dd > < p >
Print the usage summary and exit.
< / p > < / dd >
2005-12-28 23:22:58 -05:00
< dt > < span class = "term" > -q< / span > < / dt >
< dd > < p >
2007-06-02 19:21:47 -04:00
Quiet mode - exit code only.
< / p > < / dd >
2005-12-28 23:22:58 -05:00
< dt > < span class = "term" > -v< / span > < / dt >
< dd > < p >
2007-06-02 19:21:47 -04:00
Print the version of the < span > < strong class = "command" > named-checkzone< / strong > < / span >
program and exit.
< / p > < / dd >
2005-12-28 23:22:58 -05:00
< dt > < span class = "term" > -j< / span > < / dt >
< dd > < p >
2007-06-02 19:21:47 -04:00
When loading the zone file read the journal if it exists.
2005-12-28 23:22:58 -05:00
< / p > < / dd >
< dt > < span class = "term" > -c < em class = "replaceable" > < code > class< / code > < / em > < / span > < / dt >
< dd > < p >
2009-05-30 20:11:36 -04:00
Specify the class of the zone. If not specified, "IN" is assumed.
2007-06-02 19:21:47 -04:00
< / p > < / dd >
< dt > < span class = "term" > -i < em class = "replaceable" > < code > mode< / code > < / em > < / span > < / dt >
< dd >
< p >
2007-12-02 14:10:41 -05:00
Perform post-load zone integrity checks. Possible modes are
2007-06-02 19:21:47 -04: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 14:10:41 -05:00
hostnames). It also checks that glue address records
2007-06-02 19:21:47 -04: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.
2005-12-28 23:22:58 -05:00
< / p > < / dd >
< dt > < span class = "term" > -k < em class = "replaceable" > < code > mode< / code > < / em > < / span > < / dt >
< dd > < p >
2007-06-02 19:21:47 -04:00
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 > .
2005-12-28 23:22:58 -05:00
< / p > < / dd >
< dt > < span class = "term" > -n < em class = "replaceable" > < code > mode< / code > < / em > < / span > < / dt >
< dd > < p >
2007-06-02 19:21:47 -04:00
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 >
2005-12-28 23:22:58 -05:00
< dt > < span class = "term" > -o < em class = "replaceable" > < code > filename< / code > < / em > < / span > < / dt >
< dd > < p >
2007-06-02 19:21:47 -04:00
Write zone output to < code class = "filename" > filename< / code > .
2009-05-30 20:11:36 -04:00
If < code class = "filename" > filename< / code > is < code class = "filename" > -< / code > then
write to standard out.
2007-06-02 19:21:47 -04:00
This is mandatory for < span > < strong class = "command" > named-compilezone< / strong > < / span > .
2005-12-28 23:22:58 -05:00
< / p > < / dd >
2007-06-02 19:21:47 -04:00
< 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 >
2005-12-28 23:22:58 -05:00
< dt > < span class = "term" > -t < em class = "replaceable" > < code > directory< / code > < / em > < / span > < / dt >
< dd > < p >
2007-12-02 14:10:41 -05:00
Chroot to < code class = "filename" > directory< / code > so that
2007-06-02 19:21:47 -04:00
include
directives in the configuration file are processed as if
run by a similarly chrooted named.
2005-12-28 23:22:58 -05:00
< / p > < / dd >
< dt > < span class = "term" > -w < em class = "replaceable" > < code > directory< / code > < / em > < / span > < / dt >
< dd > < p >
2007-06-02 19:21:47 -04:00
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 > .
2005-12-28 23:22:58 -05:00
< / p > < / dd >
< dt > < span class = "term" > -D< / span > < / dt >
< dd > < p >
2007-06-02 19:21:47 -04:00
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 >
2005-12-28 23:22:58 -05:00
< dt > < span class = "term" > zonename< / span > < / dt >
< dd > < p >
2007-06-02 19:21:47 -04:00
The domain name of the zone being checked.
< / p > < / dd >
2005-12-28 23:22:58 -05:00
< dt > < span class = "term" > filename< / span > < / dt >
< dd > < p >
2007-06-02 19:21:47 -04:00
The name of the zone file.
< / p > < / dd >
2005-12-28 23:22:58 -05:00
< / dl > < / div >
< / div >
< div class = "refsect1" lang = "en" >
2009-05-30 20:11:36 -04:00
< a name = "id2544328" > < / a > < h2 > RETURN VALUES< / h2 >
2007-06-02 19:21:47 -04:00
< p > < span > < strong class = "command" > named-checkzone< / strong > < / span >
returns an exit status of 1 if
errors were detected and 0 otherwise.
2005-12-28 23:22:58 -05:00
< / p >
< / div >
< div class = "refsect1" lang = "en" >
2009-05-30 20:11:36 -04:00
< a name = "id2544340" > < / a > < h2 > SEE ALSO< / h2 >
2007-06-02 19:21:47 -04:00
< p > < span class = "citerefentry" > < span class = "refentrytitle" > named< / span > (8)< / span > ,
2007-12-02 14:10:41 -05:00
< span class = "citerefentry" > < span class = "refentrytitle" > named-checkconf< / span > (8)< / span > ,
2005-12-28 23:22:58 -05:00
< em class = "citetitle" > RFC 1035< / em > ,
< em class = "citetitle" > BIND 9 Administrator Reference Manual< / em > .
< / p >
< / div >
< div class = "refsect1" lang = "en" >
2009-05-30 20:11:36 -04:00
< a name = "id2544373" > < / a > < h2 > AUTHOR< / h2 >
2007-06-02 19:21:47 -04:00
< p > < span class = "corpauthor" > Internet Systems Consortium< / span >
2005-12-28 23:22:58 -05:00
< / p >
< / div >
< / div > < / body >
< / html >
