9b2bd54c98edb185a3985410367754ab33217362bnicholes<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"

9b2bd54c98edb185a3985410367754ab33217362bnicholes "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"

9b2bd54c98edb185a3985410367754ab33217362bnicholes [<!ENTITY mdash "&#8212;">]>

9b2bd54c98edb185a3985410367754ab33217362bnicholes

9b2bd54c98edb185a3985410367754ab33217362bnicholes<refentry id="man.named-checkzone">

9b2bd54c98edb185a3985410367754ab33217362bnicholes <refentryinfo>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <date>February 19, 2014</date>

9b2bd54c98edb185a3985410367754ab33217362bnicholes </refentryinfo>

9b2bd54c98edb185a3985410367754ab33217362bnicholes

9b2bd54c98edb185a3985410367754ab33217362bnicholes <refmeta>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <refentrytitle><application>named-checkzone</application></refentrytitle>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <manvolnum>8</manvolnum>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <refmiscinfo>BIND9</refmiscinfo>

9b2bd54c98edb185a3985410367754ab33217362bnicholes </refmeta>

9b2bd54c98edb185a3985410367754ab33217362bnicholes

9b2bd54c98edb185a3985410367754ab33217362bnicholes <docinfo>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <copyright>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <year>2004</year>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <year>2005</year>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <year>2006</year>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <year>2007</year>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <year>2009</year>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <year>2010</year>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <year>2011</year>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <year>2012</year>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <year>2013</year>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <year>2014</year>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <holder>Internet Systems Consortium, Inc. ("ISC")</holder>

9b2bd54c98edb185a3985410367754ab33217362bnicholes </copyright>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <copyright>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <year>2000</year>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <year>2001</year>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <year>2002</year>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <holder>Internet Software Consortium.</holder>

9b2bd54c98edb185a3985410367754ab33217362bnicholes </copyright>

9b2bd54c98edb185a3985410367754ab33217362bnicholes </docinfo>

9b2bd54c98edb185a3985410367754ab33217362bnicholes

9b2bd54c98edb185a3985410367754ab33217362bnicholes <refnamediv>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <refname><application>named-checkzone</application></refname>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <refname><application>named-compilezone</application></refname>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <refpurpose>zone file validity checking or converting tool</refpurpose>

9b2bd54c98edb185a3985410367754ab33217362bnicholes </refnamediv>

9b2bd54c98edb185a3985410367754ab33217362bnicholes

9b2bd54c98edb185a3985410367754ab33217362bnicholes <refsynopsisdiv>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <cmdsynopsis>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <command>named-checkzone</command>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-d</option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-h</option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-j</option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-q</option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-v</option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-c <replaceable class="parameter">class</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-f <replaceable class="parameter">format</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-F <replaceable class="parameter">format</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-J <replaceable class="parameter">filename</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-i <replaceable class="parameter">mode</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-k <replaceable class="parameter">mode</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-m <replaceable class="parameter">mode</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-M <replaceable class="parameter">mode</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-n <replaceable class="parameter">mode</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-l <replaceable class="parameter">ttl</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-L <replaceable class="parameter">serial</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-o <replaceable class="parameter">filename</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-r <replaceable class="parameter">mode</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-s <replaceable class="parameter">style</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-S <replaceable class="parameter">mode</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-t <replaceable class="parameter">directory</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-T <replaceable class="parameter">mode</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-w <replaceable class="parameter">directory</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-D</option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-W <replaceable class="parameter">mode</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg choice="req">zonename</arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg choice="req">filename</arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes </cmdsynopsis>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <cmdsynopsis>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <command>named-compilezone</command>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-d</option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-j</option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-q</option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-v</option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-c <replaceable class="parameter">class</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-C <replaceable class="parameter">mode</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-f <replaceable class="parameter">format</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-F <replaceable class="parameter">format</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-J <replaceable class="parameter">filename</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-i <replaceable class="parameter">mode</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-k <replaceable class="parameter">mode</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-m <replaceable class="parameter">mode</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-n <replaceable class="parameter">mode</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-l <replaceable class="parameter">ttl</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-L <replaceable class="parameter">serial</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-r <replaceable class="parameter">mode</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-s <replaceable class="parameter">style</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-t <replaceable class="parameter">directory</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-T <replaceable class="parameter">mode</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-w <replaceable class="parameter">directory</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-D</option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg><option>-W <replaceable class="parameter">mode</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg choice="req"><option>-o <replaceable class="parameter">filename</replaceable></option></arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg choice="req">zonename</arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <arg choice="req">filename</arg>

9b2bd54c98edb185a3985410367754ab33217362bnicholes </cmdsynopsis>

9b2bd54c98edb185a3985410367754ab33217362bnicholes </refsynopsisdiv>

9b2bd54c98edb185a3985410367754ab33217362bnicholes

9b2bd54c98edb185a3985410367754ab33217362bnicholes <refsect1>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <title>DESCRIPTION</title>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <para><command>named-checkzone</command>

9b2bd54c98edb185a3985410367754ab33217362bnicholes checks the syntax and integrity of a zone file. It performs the

9b2bd54c98edb185a3985410367754ab33217362bnicholes same checks as <command>named</command> does when loading a

9b2bd54c98edb185a3985410367754ab33217362bnicholes zone. This makes <command>named-checkzone</command> useful for

9b2bd54c98edb185a3985410367754ab33217362bnicholes checking zone files before configuring them into a name server.

9b2bd54c98edb185a3985410367754ab33217362bnicholes </para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <command>named-compilezone</command> is similar to

9b2bd54c98edb185a3985410367754ab33217362bnicholes <command>named-checkzone</command>, but it always dumps the

9b2bd54c98edb185a3985410367754ab33217362bnicholes zone contents to a specified file in a specified format.

9b2bd54c98edb185a3985410367754ab33217362bnicholes Additionally, it applies stricter check levels by default,

9b2bd54c98edb185a3985410367754ab33217362bnicholes since the dump output will be used as an actual zone file

9b2bd54c98edb185a3985410367754ab33217362bnicholes loaded by <command>named</command>.

9b2bd54c98edb185a3985410367754ab33217362bnicholes When manually specified otherwise, the check levels must at

9b2bd54c98edb185a3985410367754ab33217362bnicholes least be as strict as those specified in the

9b2bd54c98edb185a3985410367754ab33217362bnicholes <command>named</command> configuration file.

9b2bd54c98edb185a3985410367754ab33217362bnicholes </para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes </refsect1>

9b2bd54c98edb185a3985410367754ab33217362bnicholes

9b2bd54c98edb185a3985410367754ab33217362bnicholes <refsect1>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <title>OPTIONS</title>

9b2bd54c98edb185a3985410367754ab33217362bnicholes

9b2bd54c98edb185a3985410367754ab33217362bnicholes <variablelist>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <varlistentry>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <term>-d</term>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <listitem>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes Enable debugging.

9b2bd54c98edb185a3985410367754ab33217362bnicholes </para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes </listitem>

9b2bd54c98edb185a3985410367754ab33217362bnicholes </varlistentry>

9b2bd54c98edb185a3985410367754ab33217362bnicholes

9b2bd54c98edb185a3985410367754ab33217362bnicholes <varlistentry>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <term>-h</term>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <listitem>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes Print the usage summary and exit.

9b2bd54c98edb185a3985410367754ab33217362bnicholes </para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes </listitem>

9b2bd54c98edb185a3985410367754ab33217362bnicholes </varlistentry>

9b2bd54c98edb185a3985410367754ab33217362bnicholes

9b2bd54c98edb185a3985410367754ab33217362bnicholes <varlistentry>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <term>-q</term>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <listitem>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes Quiet mode - exit code only.

9b2bd54c98edb185a3985410367754ab33217362bnicholes </para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes </listitem>

9b2bd54c98edb185a3985410367754ab33217362bnicholes </varlistentry>

9b2bd54c98edb185a3985410367754ab33217362bnicholes

9b2bd54c98edb185a3985410367754ab33217362bnicholes <varlistentry>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <term>-v</term>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <listitem>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes Print the version of the <command>named-checkzone</command>

9b2bd54c98edb185a3985410367754ab33217362bnicholes program and exit.

9b2bd54c98edb185a3985410367754ab33217362bnicholes </para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes </listitem>

9b2bd54c98edb185a3985410367754ab33217362bnicholes </varlistentry>

9b2bd54c98edb185a3985410367754ab33217362bnicholes

9b2bd54c98edb185a3985410367754ab33217362bnicholes <varlistentry>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <term>-j</term>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <listitem>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes When loading a zone file, read the journal if it exists.

9b2bd54c98edb185a3985410367754ab33217362bnicholes The journal file name is assumed to be the zone file name

9b2bd54c98edb185a3985410367754ab33217362bnicholes appended with the string <filename>.jnl</filename>.

9b2bd54c98edb185a3985410367754ab33217362bnicholes </para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes </listitem>

9b2bd54c98edb185a3985410367754ab33217362bnicholes </varlistentry>

9b2bd54c98edb185a3985410367754ab33217362bnicholes

9b2bd54c98edb185a3985410367754ab33217362bnicholes <varlistentry>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <term>-J <replaceable class="parameter">filename</replaceable></term>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <listitem>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes When loading the zone file read the journal from the given

9b2bd54c98edb185a3985410367754ab33217362bnicholes file, if it exists. (Implies -j.)

9b2bd54c98edb185a3985410367754ab33217362bnicholes </para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes </listitem>

9b2bd54c98edb185a3985410367754ab33217362bnicholes </varlistentry>

9b2bd54c98edb185a3985410367754ab33217362bnicholes

9b2bd54c98edb185a3985410367754ab33217362bnicholes <varlistentry>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <term>-c <replaceable class="parameter">class</replaceable></term>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <listitem>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes Specify the class of the zone. If not specified, "IN" is assumed.

9b2bd54c98edb185a3985410367754ab33217362bnicholes </para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes </listitem>

9b2bd54c98edb185a3985410367754ab33217362bnicholes </varlistentry>

9b2bd54c98edb185a3985410367754ab33217362bnicholes

9b2bd54c98edb185a3985410367754ab33217362bnicholes <varlistentry>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <term>-i <replaceable class="parameter">mode</replaceable></term>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <listitem>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes Perform post-load zone integrity checks. Possible modes are

9b2bd54c98edb185a3985410367754ab33217362bnicholes <command>"full"</command> (default),

9b2bd54c98edb185a3985410367754ab33217362bnicholes <command>"full-sibling"</command>,

9b2bd54c98edb185a3985410367754ab33217362bnicholes <command>"local"</command>,

9b2bd54c98edb185a3985410367754ab33217362bnicholes <command>"local-sibling"</command> and

9b2bd54c98edb185a3985410367754ab33217362bnicholes <command>"none"</command>.

9b2bd54c98edb185a3985410367754ab33217362bnicholes </para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes Mode <command>"full"</command> checks that MX records

9b2bd54c98edb185a3985410367754ab33217362bnicholes refer to A or AAAA record (both in-zone and out-of-zone

9b2bd54c98edb185a3985410367754ab33217362bnicholes hostnames). Mode <command>"local"</command> only

9b2bd54c98edb185a3985410367754ab33217362bnicholes checks MX records which refer to in-zone hostnames.

9b2bd54c98edb185a3985410367754ab33217362bnicholes </para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes Mode <command>"full"</command> checks that SRV records

9b2bd54c98edb185a3985410367754ab33217362bnicholes refer to A or AAAA record (both in-zone and out-of-zone

9b2bd54c98edb185a3985410367754ab33217362bnicholes hostnames). Mode <command>"local"</command> only

9b2bd54c98edb185a3985410367754ab33217362bnicholes checks SRV records which refer to in-zone hostnames.

9b2bd54c98edb185a3985410367754ab33217362bnicholes </para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes Mode <command>"full"</command> checks that delegation NS

9b2bd54c98edb185a3985410367754ab33217362bnicholes records refer to A or AAAA record (both in-zone and out-of-zone

9b2bd54c98edb185a3985410367754ab33217362bnicholes hostnames). It also checks that glue address records

9b2bd54c98edb185a3985410367754ab33217362bnicholes in the zone match those advertised by the child.

9b2bd54c98edb185a3985410367754ab33217362bnicholes Mode <command>"local"</command> only checks NS records which

9b2bd54c98edb185a3985410367754ab33217362bnicholes refer to in-zone hostnames or that some required glue exists,

9b2bd54c98edb185a3985410367754ab33217362bnicholes that is when the nameserver is in a child zone.

9b2bd54c98edb185a3985410367754ab33217362bnicholes </para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes Mode <command>"full-sibling"</command> and

9b2bd54c98edb185a3985410367754ab33217362bnicholes <command>"local-sibling"</command> disable sibling glue

9b2bd54c98edb185a3985410367754ab33217362bnicholes checks but are otherwise the same as <command>"full"</command>

9b2bd54c98edb185a3985410367754ab33217362bnicholes and <command>"local"</command> respectively.

9b2bd54c98edb185a3985410367754ab33217362bnicholes </para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes Mode <command>"none"</command> disables the checks.

9b2bd54c98edb185a3985410367754ab33217362bnicholes </para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes </listitem>

9b2bd54c98edb185a3985410367754ab33217362bnicholes </varlistentry>

9b2bd54c98edb185a3985410367754ab33217362bnicholes

9b2bd54c98edb185a3985410367754ab33217362bnicholes <varlistentry>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <term>-f <replaceable class="parameter">format</replaceable></term>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <listitem>

9b2bd54c98edb185a3985410367754ab33217362bnicholes <para>

9b2bd54c98edb185a3985410367754ab33217362bnicholes Specify the format of the zone file.

9b2bd54c98edb185a3985410367754ab33217362bnicholes Possible formats are <command>"text"</command> (default),

9b2bd54c98edb185a3985410367754ab33217362bnicholes <command>"raw"</command>, and <command>"map"</command>.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>-F <replaceable class="parameter">format</replaceable></term>

<listitem>

<para>

Specify the format of the output file specified.

For <command>named-checkzone</command>,

this does not cause any effects unless it dumps the zone

contents.

</para>

<para>

Possible formats are <command>"text"</command> (default),

which is the standard textual representation of the zone,

and <command>"map"</command>, <command>"raw"</command>,

and <command>"raw=N"</command>, which store the zone in a

binary format for rapid loading by <command>named</command>.

<command>"raw=N"</command> specifies the format version of

the raw zone file: if N is 0, the raw file can be read by

any version of <command>named</command>; if N is 1, the file

can be read by release 9.9.0 or higher; the default is 1.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>-k <replaceable class="parameter">mode</replaceable></term>

<listitem>

<para>

Perform <command>"check-names"</command> checks with the

specified failure mode.

Possible modes are <command>"fail"</command>

(default for <command>named-compilezone</command>),

<command>"warn"</command>

(default for <command>named-checkzone</command>) and

<command>"ignore"</command>.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>-l <replaceable class="parameter">ttl</replaceable></term>

<listitem>

<para>

Sets a maximum permissible TTL for the input file.

Any record with a TTL higher than this value will cause

the zone to be rejected. This is similar to using the

<command>max-zone-ttl</command> option in

<filename>named.conf</filename>.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>-L <replaceable class="parameter">serial</replaceable></term>

<listitem>

<para>

When compiling a zone to "raw" or "map" format, set the

"source serial" value in the header to the specified serial

number. (This is expected to be used primarily for testing

purposes.)

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>-m <replaceable class="parameter">mode</replaceable></term>

<listitem>

<para>

Specify whether MX records should be checked to see if they

are addresses. Possible modes are <command>"fail"</command>,

<command>"warn"</command> (default) and

<command>"ignore"</command>.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>-M <replaceable class="parameter">mode</replaceable></term>

<listitem>

<para>

Check if a MX record refers to a CNAME.

Possible modes are <command>"fail"</command>,

<command>"warn"</command> (default) and

<command>"ignore"</command>.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>-n <replaceable class="parameter">mode</replaceable></term>

<listitem>

<para>

Specify whether NS records should be checked to see if they

are addresses.

Possible modes are <command>"fail"</command>

(default for <command>named-compilezone</command>),

<command>"warn"</command>

(default for <command>named-checkzone</command>) and

<command>"ignore"</command>.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>-o <replaceable class="parameter">filename</replaceable></term>

<listitem>

<para>

Write zone output to <filename>filename</filename>.

If <filename>filename</filename> is <filename>-</filename> then

write to standard out.

This is mandatory for <command>named-compilezone</command>.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>-r <replaceable class="parameter">mode</replaceable></term>

<listitem>

<para>

Check for records that are treated as different by DNSSEC but

are semantically equal in plain DNS.

Possible modes are <command>"fail"</command>,

<command>"warn"</command> (default) and

<command>"ignore"</command>.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>-s <replaceable class="parameter">style</replaceable></term>

<listitem>

<para>

Specify the style of the dumped zone file.

Possible styles are <command>"full"</command> (default)

and <command>"relative"</command>.

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 <command>named-checkzone</command>

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.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>-S <replaceable class="parameter">mode</replaceable></term>

<listitem>

<para>

Check if a SRV record refers to a CNAME.

Possible modes are <command>"fail"</command>,

<command>"warn"</command> (default) and

<command>"ignore"</command>.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>-t <replaceable class="parameter">directory</replaceable></term>

<listitem>

<para>

Chroot to <filename>directory</filename> so that

include

directives in the configuration file are processed as if

run by a similarly chrooted <command>named</command>.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>-T <replaceable class="parameter">mode</replaceable></term>

<listitem>

<para>

Check if Sender Policy Framework (SPF) records exist

and issues a warning if an SPF-formatted TXT record is

not also present. Possible modes are <command>"warn"</command>

(default), <command>"ignore"</command>.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>-w <replaceable class="parameter">directory</replaceable></term>

<listitem>

<para>

chdir to <filename>directory</filename> so that

relative

filenames in master file $INCLUDE directives work. This

is similar to the directory clause in

<filename>named.conf</filename>.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>-D</term>

<listitem>

<para>

Dump zone file in canonical format.

This is always enabled for <command>named-compilezone</command>.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>-W <replaceable class="parameter">mode</replaceable></term>

<listitem>

<para>

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 <command>"warn"</command> (default)

and

<command>"ignore"</command>.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>zonename</term>

<listitem>

<para>

The domain name of the zone being checked.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>filename</term>

<listitem>

<para>

The name of the zone file.

</para>

</listitem>

</varlistentry>

</variablelist>

</refsect1>

<refsect1>

<title>RETURN VALUES</title>

<para><command>named-checkzone</command>

returns an exit status of 1 if

errors were detected and 0 otherwise.

</para>

</refsect1>

<refsect1>

<title>SEE ALSO</title>

<para><citerefentry>

<refentrytitle>named</refentrytitle><manvolnum>8</manvolnum>

</citerefentry>,

<citerefentry>

<refentrytitle>named-checkconf</refentrytitle><manvolnum>8</manvolnum>

</citerefentry>,

<citetitle>RFC 1035</citetitle>,

<citetitle>BIND 9 Administrator Reference Manual</citetitle>.

</para>

</refsect1>

<refsect1>

<title>AUTHOR</title>

<para><corpauthor>Internet Systems Consortium</corpauthor>

</para>

</refsect1>

</refentry><!--