named-checkzone.html revision 2cd182921e1b04ccda0a56995c4cc491c882af04
2765a47c64de85888aa0aaa11a447253d2c32327is<!--
2765a47c64de85888aa0aaa11a447253d2c32327is - Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC")
2765a47c64de85888aa0aaa11a447253d2c32327is - Copyright (C) 2001, 2002 Internet Software Consortium.
2765a47c64de85888aa0aaa11a447253d2c32327is -
2765a47c64de85888aa0aaa11a447253d2c32327is - Permission to use, copy, modify, and distribute this software for any
2765a47c64de85888aa0aaa11a447253d2c32327is - purpose with or without fee is hereby granted, provided that the above
2765a47c64de85888aa0aaa11a447253d2c32327is - copyright notice and this permission notice appear in all copies.
2765a47c64de85888aa0aaa11a447253d2c32327is -
2765a47c64de85888aa0aaa11a447253d2c32327is - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
2765a47c64de85888aa0aaa11a447253d2c32327is - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
2765a47c64de85888aa0aaa11a447253d2c32327is - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
2765a47c64de85888aa0aaa11a447253d2c32327is - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
2765a47c64de85888aa0aaa11a447253d2c32327is - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
2765a47c64de85888aa0aaa11a447253d2c32327is - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
2765a47c64de85888aa0aaa11a447253d2c32327is - PERFORMANCE OF THIS SOFTWARE.
2765a47c64de85888aa0aaa11a447253d2c32327is-->
2765a47c64de85888aa0aaa11a447253d2c32327is
2765a47c64de85888aa0aaa11a447253d2c32327is<!-- $Id: named-checkzone.html,v 1.15 2004/08/23 00:05:43 marka Exp $ -->
2765a47c64de85888aa0aaa11a447253d2c32327is
2765a47c64de85888aa0aaa11a447253d2c32327is<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2765a47c64de85888aa0aaa11a447253d2c32327is<HTML
2765a47c64de85888aa0aaa11a447253d2c32327is><HEAD
2765a47c64de85888aa0aaa11a447253d2c32327is><TITLE
2765a47c64de85888aa0aaa11a447253d2c32327is>named-checkzone</TITLE
2765a47c64de85888aa0aaa11a447253d2c32327is><META
2765a47c64de85888aa0aaa11a447253d2c32327isNAME="GENERATOR"
2765a47c64de85888aa0aaa11a447253d2c32327isCONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
2765a47c64de85888aa0aaa11a447253d2c32327is><BODY
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="REFENTRY"
2765a47c64de85888aa0aaa11a447253d2c32327isBGCOLOR="#FFFFFF"
2765a47c64de85888aa0aaa11a447253d2c32327isTEXT="#000000"
2765a47c64de85888aa0aaa11a447253d2c32327isLINK="#0000FF"
2765a47c64de85888aa0aaa11a447253d2c32327isVLINK="#840084"
2765a47c64de85888aa0aaa11a447253d2c32327isALINK="#0000FF"
2765a47c64de85888aa0aaa11a447253d2c32327is><H1
2765a47c64de85888aa0aaa11a447253d2c32327is><A
2765a47c64de85888aa0aaa11a447253d2c32327isNAME="AEN1"
2765a47c64de85888aa0aaa11a447253d2c32327is></A
2765a47c64de85888aa0aaa11a447253d2c32327is><SPAN
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="APPLICATION"
2765a47c64de85888aa0aaa11a447253d2c32327is>named-checkzone</SPAN
2765a47c64de85888aa0aaa11a447253d2c32327is></H1
2765a47c64de85888aa0aaa11a447253d2c32327is><DIV
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="REFNAMEDIV"
2765a47c64de85888aa0aaa11a447253d2c32327is><A
2765a47c64de85888aa0aaa11a447253d2c32327isNAME="AEN9"
2765a47c64de85888aa0aaa11a447253d2c32327is></A
2765a47c64de85888aa0aaa11a447253d2c32327is><H2
2765a47c64de85888aa0aaa11a447253d2c32327is>Name</H2
2765a47c64de85888aa0aaa11a447253d2c32327is><SPAN
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="APPLICATION"
2765a47c64de85888aa0aaa11a447253d2c32327is>named-checkzone</SPAN
2765a47c64de85888aa0aaa11a447253d2c32327is>&nbsp;--&nbsp;zone file validity checking tool</DIV
2765a47c64de85888aa0aaa11a447253d2c32327is><DIV
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="REFSYNOPSISDIV"
2765a47c64de85888aa0aaa11a447253d2c32327is><A
2765a47c64de85888aa0aaa11a447253d2c32327isNAME="AEN13"
2765a47c64de85888aa0aaa11a447253d2c32327is></A
2765a47c64de85888aa0aaa11a447253d2c32327is><H2
2765a47c64de85888aa0aaa11a447253d2c32327is>Synopsis</H2
2765a47c64de85888aa0aaa11a447253d2c32327is><P
2765a47c64de85888aa0aaa11a447253d2c32327is><B
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="COMMAND"
2765a47c64de85888aa0aaa11a447253d2c32327is>named-checkzone</B
2765a47c64de85888aa0aaa11a447253d2c32327is> [<VAR
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="OPTION"
2765a47c64de85888aa0aaa11a447253d2c32327is>-d</VAR
2765a47c64de85888aa0aaa11a447253d2c32327is>] [<VAR
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="OPTION"
2765a47c64de85888aa0aaa11a447253d2c32327is>-j</VAR
2765a47c64de85888aa0aaa11a447253d2c32327is>] [<VAR
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="OPTION"
2765a47c64de85888aa0aaa11a447253d2c32327is>-q</VAR
2765a47c64de85888aa0aaa11a447253d2c32327is>] [<VAR
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="OPTION"
2765a47c64de85888aa0aaa11a447253d2c32327is>-v</VAR
2765a47c64de85888aa0aaa11a447253d2c32327is>] [<VAR
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="OPTION"
2765a47c64de85888aa0aaa11a447253d2c32327is>-c <VAR
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="REPLACEABLE"
2765a47c64de85888aa0aaa11a447253d2c32327is>class</VAR
2765a47c64de85888aa0aaa11a447253d2c32327is></VAR
2765a47c64de85888aa0aaa11a447253d2c32327is>] [<VAR
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="OPTION"
2765a47c64de85888aa0aaa11a447253d2c32327is>-k <VAR
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="REPLACEABLE"
2765a47c64de85888aa0aaa11a447253d2c32327is>mode</VAR
2765a47c64de85888aa0aaa11a447253d2c32327is></VAR
2765a47c64de85888aa0aaa11a447253d2c32327is>] [<VAR
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="OPTION"
2765a47c64de85888aa0aaa11a447253d2c32327is>-n <VAR
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="REPLACEABLE"
2765a47c64de85888aa0aaa11a447253d2c32327is>mode</VAR
2765a47c64de85888aa0aaa11a447253d2c32327is></VAR
2765a47c64de85888aa0aaa11a447253d2c32327is>] [<VAR
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="OPTION"
2765a47c64de85888aa0aaa11a447253d2c32327is>-o <VAR
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="REPLACEABLE"
2765a47c64de85888aa0aaa11a447253d2c32327is>filename</VAR
2765a47c64de85888aa0aaa11a447253d2c32327is></VAR
2765a47c64de85888aa0aaa11a447253d2c32327is>] [<VAR
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="OPTION"
2765a47c64de85888aa0aaa11a447253d2c32327is>-t <VAR
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="REPLACEABLE"
2765a47c64de85888aa0aaa11a447253d2c32327is>directory</VAR
2765a47c64de85888aa0aaa11a447253d2c32327is></VAR
2765a47c64de85888aa0aaa11a447253d2c32327is>] [<VAR
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="OPTION"
2765a47c64de85888aa0aaa11a447253d2c32327is>-w <VAR
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="REPLACEABLE"
2765a47c64de85888aa0aaa11a447253d2c32327is>directory</VAR
2765a47c64de85888aa0aaa11a447253d2c32327is></VAR
2765a47c64de85888aa0aaa11a447253d2c32327is>] [<VAR
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="OPTION"
2765a47c64de85888aa0aaa11a447253d2c32327is>-D</VAR
2765a47c64de85888aa0aaa11a447253d2c32327is>] {zonename} {filename}</P
2765a47c64de85888aa0aaa11a447253d2c32327is></DIV
2765a47c64de85888aa0aaa11a447253d2c32327is><DIV
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="REFSECT1"
2765a47c64de85888aa0aaa11a447253d2c32327is><A
2765a47c64de85888aa0aaa11a447253d2c32327isNAME="AEN46"
2765a47c64de85888aa0aaa11a447253d2c32327is></A
2765a47c64de85888aa0aaa11a447253d2c32327is><H2
2765a47c64de85888aa0aaa11a447253d2c32327is>DESCRIPTION</H2
2765a47c64de85888aa0aaa11a447253d2c32327is><P
2765a47c64de85888aa0aaa11a447253d2c32327is> <B
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="COMMAND"
2765a47c64de85888aa0aaa11a447253d2c32327is>named-checkzone</B
2765a47c64de85888aa0aaa11a447253d2c32327is> checks the syntax and integrity of
2765a47c64de85888aa0aaa11a447253d2c32327is a zone file. It performs the same checks as <B
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="COMMAND"
2765a47c64de85888aa0aaa11a447253d2c32327is>named</B
2765a47c64de85888aa0aaa11a447253d2c32327is>
2765a47c64de85888aa0aaa11a447253d2c32327is does when loading a zone. This makes
2765a47c64de85888aa0aaa11a447253d2c32327is <B
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="COMMAND"
2765a47c64de85888aa0aaa11a447253d2c32327is>named-checkzone</B
2765a47c64de85888aa0aaa11a447253d2c32327is> useful for checking zone
2765a47c64de85888aa0aaa11a447253d2c32327is files before configuring them into a name server.
2765a47c64de85888aa0aaa11a447253d2c32327is </P
2765a47c64de85888aa0aaa11a447253d2c32327is></DIV
2765a47c64de85888aa0aaa11a447253d2c32327is><DIV
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="REFSECT1"
2765a47c64de85888aa0aaa11a447253d2c32327is><A
2765a47c64de85888aa0aaa11a447253d2c32327isNAME="AEN52"
2765a47c64de85888aa0aaa11a447253d2c32327is></A
2765a47c64de85888aa0aaa11a447253d2c32327is><H2
2765a47c64de85888aa0aaa11a447253d2c32327is>OPTIONS</H2
2765a47c64de85888aa0aaa11a447253d2c32327is><P
2765a47c64de85888aa0aaa11a447253d2c32327is></P
2765a47c64de85888aa0aaa11a447253d2c32327is><DIV
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="VARIABLELIST"
2765a47c64de85888aa0aaa11a447253d2c32327is><DL
2765a47c64de85888aa0aaa11a447253d2c32327is><DT
2765a47c64de85888aa0aaa11a447253d2c32327is>-d</DT
2765a47c64de85888aa0aaa11a447253d2c32327is><DD
2765a47c64de85888aa0aaa11a447253d2c32327is><P
2765a47c64de85888aa0aaa11a447253d2c32327is> Enable debugging.
2765a47c64de85888aa0aaa11a447253d2c32327is </P
2765a47c64de85888aa0aaa11a447253d2c32327is></DD
2765a47c64de85888aa0aaa11a447253d2c32327is><DT
2765a47c64de85888aa0aaa11a447253d2c32327is>-q</DT
2765a47c64de85888aa0aaa11a447253d2c32327is><DD
2765a47c64de85888aa0aaa11a447253d2c32327is><P
2765a47c64de85888aa0aaa11a447253d2c32327is> Quiet mode - exit code only.
2765a47c64de85888aa0aaa11a447253d2c32327is </P
2765a47c64de85888aa0aaa11a447253d2c32327is></DD
2765a47c64de85888aa0aaa11a447253d2c32327is><DT
2765a47c64de85888aa0aaa11a447253d2c32327is>-v</DT
2765a47c64de85888aa0aaa11a447253d2c32327is><DD
2765a47c64de85888aa0aaa11a447253d2c32327is><P
2765a47c64de85888aa0aaa11a447253d2c32327is> Print the version of the <B
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="COMMAND"
2765a47c64de85888aa0aaa11a447253d2c32327is>named-checkzone</B
2765a47c64de85888aa0aaa11a447253d2c32327is>
2765a47c64de85888aa0aaa11a447253d2c32327is program and exit.
2765a47c64de85888aa0aaa11a447253d2c32327is </P
2765a47c64de85888aa0aaa11a447253d2c32327is></DD
2765a47c64de85888aa0aaa11a447253d2c32327is><DT
2765a47c64de85888aa0aaa11a447253d2c32327is>-j</DT
2765a47c64de85888aa0aaa11a447253d2c32327is><DD
2765a47c64de85888aa0aaa11a447253d2c32327is><P
2765a47c64de85888aa0aaa11a447253d2c32327is> When loading the zone file read the journal if it exists.
2765a47c64de85888aa0aaa11a447253d2c32327is </P
2765a47c64de85888aa0aaa11a447253d2c32327is></DD
2765a47c64de85888aa0aaa11a447253d2c32327is><DT
2765a47c64de85888aa0aaa11a447253d2c32327is>-c <VAR
2765a47c64de85888aa0aaa11a447253d2c32327isCLASS="REPLACEABLE"
2765a47c64de85888aa0aaa11a447253d2c32327is>class</VAR
2765a47c64de85888aa0aaa11a447253d2c32327is></DT
2765a47c64de85888aa0aaa11a447253d2c32327is><DD
2765a47c64de85888aa0aaa11a447253d2c32327is><P
> Specify the class of the zone. If not specified "IN" is assumed.
</P
></DD
><DT
>-k <VAR
CLASS="REPLACEABLE"
>mode</VAR
></DT
><DD
><P
> Perform <B
CLASS="COMMAND"
>"check-name"</B
> checks with the specified failure mode.
Possible modes are <B
CLASS="COMMAND"
>"fail"</B
>,
<B
CLASS="COMMAND"
>"warn"</B
> (default) and
<B
CLASS="COMMAND"
>"ignore"</B
>.
</P
></DD
><DT
>-n <VAR
CLASS="REPLACEABLE"
>mode</VAR
></DT
><DD
><P
> Specify whether NS records should be checked to see if they
are addresses. Possible modes are <B
CLASS="COMMAND"
>"fail"</B
>,
<B
CLASS="COMMAND"
>"warn"</B
> (default) and
<B
CLASS="COMMAND"
>"ignore"</B
>.
</P
></DD
><DT
>-o <VAR
CLASS="REPLACEABLE"
>filename</VAR
></DT
><DD
><P
> Write zone output to <TT
CLASS="FILENAME"
>directory</TT
>.
</P
></DD
><DT
>-t <VAR
CLASS="REPLACEABLE"
>directory</VAR
></DT
><DD
><P
> chroot to <TT
CLASS="FILENAME"
>directory</TT
> so that include
directives in the configuration file are processed as if
run by a similarly chrooted named.
</P
></DD
><DT
>-w <VAR
CLASS="REPLACEABLE"
>directory</VAR
></DT
><DD
><P
> chdir to <TT
CLASS="FILENAME"
>directory</TT
> so that relative
filenames in master file $INCLUDE directives work. This
is similar to the directory clause in
<TT
CLASS="FILENAME"
>named.conf</TT
>.
</P
></DD
><DT
>-D</DT
><DD
><P
> Dump zone file in canonical format.
</P
></DD
><DT
>zonename</DT
><DD
><P
> The domain name of the zone being checked.
</P
></DD
><DT
>filename</DT
><DD
><P
> The name of the zone file.
</P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN125"
></A
><H2
>RETURN VALUES</H2
><P
> <B
CLASS="COMMAND"
>named-checkzone</B
> returns an exit status of 1 if
errors were detected and 0 otherwise.
</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN129"
></A
><H2
>SEE ALSO</H2
><P
> <SPAN
CLASS="CITEREFENTRY"
><SPAN
CLASS="REFENTRYTITLE"
>named</SPAN
>(8)</SPAN
>,
<I
CLASS="CITETITLE"
>RFC 1035</I
>,
<I
CLASS="CITETITLE"
>BIND 9 Administrator Reference Manual</I
>.
</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN137"
></A
><H2
>AUTHOR</H2
><P
> Internet Systems Consortium
</P
></DIV
></BODY
></HTML
>