2005-07-19 06:12:24 +00:00
<!--
2011-01-05 01:14:09 +00:00
- Copyright (C) 2004-2011 Internet Systems Consortium, Inc. ("ISC")
2005-07-19 06:12:24 +00:00
- Copyright (C) 2000-2003 Internet Software Consortium.
-
2009-07-11 01:12:47 +00:00
- Permission to use, copy, modify, and/or distribute this software for any
2005-07-19 06:12:24 +00:00
- 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.
-->
2011-11-24 01:14:53 +00:00
<!-- $Id: man.named - checkzone.html,v 1.213 2011/11/24 01:14:52 tbox Exp $ -->
2005-07-19 06:12:24 +00:00
< html >
< head >
< meta http-equiv = "Content-Type" content = "text/html; charset=ISO-8859-1" >
< title > named-checkzone< / title >
2006-12-12 01:45:21 +00:00
< meta name = "generator" content = "DocBook XSL Stylesheets V1.71.1" >
2005-07-19 06:12:24 +00:00
< 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 >
2010-01-17 01:14:02 +00: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" > -r < em class = "replaceable" > < code > mode< / 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" > -r < em class = "replaceable" > < code > mode< / 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 > ] {< code class = "option" > -o < em class = "replaceable" > < code > filename< / code > < / em > < / code > } {zonename} {filename}< / p > < / div >
2005-07-19 06:12:24 +00:00
< / div >
< div class = "refsect1" lang = "en" >
2011-11-24 01:14:53 +00:00
< a name = "id2619882" > < / a > < h2 > DESCRIPTION< / h2 >
2005-07-19 06:12:24 +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-05-09 13:35:57 +00:00
When manually specified otherwise, the check levels must at
2005-07-19 06:12:24 +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" >
2011-11-24 01:14:53 +00:00
< a name = "id2619932" > < / a > < h2 > OPTIONS< / h2 >
2005-07-19 06:12:24 +00:00
< div class = "variablelist" > < dl >
< dt > < span class = "term" > -d< / span > < / dt >
< dd > < p >
Enable debugging.
< / p > < / dd >
2007-05-21 04:09:03 +00:00
< dt > < span class = "term" > -h< / span > < / dt >
< dd > < p >
Print the usage summary and exit.
< / p > < / dd >
2005-07-19 06:12:24 +00:00
< 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 >
2009-01-21 01:12:08 +00:00
Specify the class of the zone. If not specified, "IN" is assumed.
2005-07-19 06:12:24 +00:00
< / p > < / dd >
< dt > < span class = "term" > -i < em class = "replaceable" > < code > mode< / code > < / em > < / span > < / dt >
< dd >
< p >
2007-05-09 03:33:51 +00:00
Perform post-load zone integrity checks. Possible modes are
2005-07-19 06:12:24 +00:00
< span > < strong class = "command" > "full"< / strong > < / span > (default),
2005-08-25 03:12:48 +00:00
< span > < strong class = "command" > "full-sibling"< / strong > < / span > ,
< span > < strong class = "command" > "local"< / strong > < / span > ,
< span > < strong class = "command" > "local-sibling"< / strong > < / span > and
2005-07-19 06:12:24 +00:00
< 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-05-09 03:33:51 +00:00
hostnames). It also checks that glue address records
2005-07-19 06:12:24 +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 >
2005-08-25 03:12:48 +00:00
< 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 >
2005-07-19 06:12:24 +00:00
< 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 >
2006-09-29 08:34:55 +00:00
Perform < span > < strong class = "command" > "check-names"< / strong > < / span > checks with the
2005-07-19 06:12:24 +00:00
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 >
2006-01-06 01:55:39 +00:00
< 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 >
2005-07-19 06:12:24 +00:00
< 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 > .
2007-05-21 04:09:03 +00:00
If < code class = "filename" > filename< / code > is < code class = "filename" > -< / code > then
write to standard out.
2005-07-19 06:12:24 +00:00
This is mandatory for < span > < strong class = "command" > named-compilezone< / strong > < / span > .
< / p > < / dd >
2009-12-04 22:22:27 +00:00
< dt > < span class = "term" > -r < em class = "replaceable" > < code > mode< / code > < / em > < / span > < / dt >
< dd > < p >
Check for records that are treated as different by DNSSEC but
are semantically equal in plain DNS.
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-07-19 06:12:24 +00: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)
2006-08-31 00:19:52 +00:00
and < span > < strong class = "command" > "relative"< / strong > < / span > .
2005-07-19 06:12:24 +00:00
The full format is most suitable for processing
automatically by a separate script.
2006-08-31 00:19:52 +00:00
On the other hand, the relative format is more
2005-07-19 06:12:24 +00:00
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 >
2006-01-06 01:55:39 +00:00
< 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-07-19 06:12:24 +00:00
< dt > < span class = "term" > -t < em class = "replaceable" > < code > directory< / code > < / em > < / span > < / dt >
< dd > < p >
2007-05-09 03:33:51 +00:00
Chroot to < code class = "filename" > directory< / code > so that
2005-07-19 06:12:24 +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" >
2011-11-24 01:14:53 +00:00
< a name = "id2671904" > < / a > < h2 > RETURN VALUES< / h2 >
2005-07-19 06:12:24 +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" >
2011-11-24 01:14:53 +00:00
< a name = "id2671917" > < / a > < h2 > SEE ALSO< / h2 >
2005-07-19 06:12:24 +00:00
< p > < span class = "citerefentry" > < span class = "refentrytitle" > named< / span > (8)< / span > ,
2007-06-20 02:27:33 +00:00
< span class = "citerefentry" > < span class = "refentrytitle" > named-checkconf< / span > (8)< / span > ,
2005-07-19 06:12:24 +00:00
< em class = "citetitle" > RFC 1035< / em > ,
< em class = "citetitle" > BIND 9 Administrator Reference Manual< / em > .
< / p >
< / div >
< div class = "refsect1" lang = "en" >
2011-11-24 01:14:53 +00:00
< a name = "id2671950" > < / a > < h2 > AUTHOR< / h2 >
2005-07-19 06:12:24 +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 >
2007-01-26 23:29:04 +00:00
< td width = "40%" align = "left" valign = "top" >
< span class = "application" > named-checkconf< / span > <EFBFBD> < / td >
2005-07-19 06:12:24 +00:00
< td width = "20%" align = "center" > < a accesskey = "h" href = "Bv9ARM.html" > Home< / a > < / td >
2007-01-26 23:29:04 +00:00
< td width = "40%" align = "right" valign = "top" > <EFBFBD> < span class = "application" > named< / span >
< / td >
2005-07-19 06:12:24 +00:00
< / tr >
< / table >
< / div >
< / body >
< / html >
