48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross<!DOCTYPE book [

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross<!ENTITY mdash "&#8212;">]>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="man.named-checkconf">

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <info>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <date>2014-01-10</date>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross </info>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <refentryinfo>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <corpname>ISC</corpname>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <corpauthor>Internet Systems Consortium, Inc.</corpauthor>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross </refentryinfo>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <refmeta>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <refentrytitle><application>named-checkconf</application></refentrytitle>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <manvolnum>8</manvolnum>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <refmiscinfo>BIND9</refmiscinfo>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross </refmeta>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <docinfo>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <copyright>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <year>2004</year>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <year>2005</year>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <year>2007</year>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <year>2009</year>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <year>2014</year>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <year>2015</year>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <holder>Internet Systems Consortium, Inc. ("ISC")</holder>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross </copyright>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <copyright>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <year>2000</year>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <year>2001</year>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <year>2002</year>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <holder>Internet Software Consortium.</holder>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross </copyright>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross </docinfo>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <refnamediv>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <refname><application>named-checkconf</application></refname>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <refpurpose>named configuration file syntax checking tool</refpurpose>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross </refnamediv>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <refsynopsisdiv>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <cmdsynopsis sepchar=" ">

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <command>named-checkconf</command>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <arg choice="opt" rep="norepeat"><option>-h</option></arg>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <arg choice="opt" rep="norepeat"><option>-v</option></arg>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <arg choice="opt" rep="norepeat"><option>-j</option></arg>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <arg choice="opt" rep="norepeat"><option>-t <replaceable class="parameter">directory</replaceable></option></arg>

48edc7cf07b5dccc3ad84bf2dafe4150bd666d60Gordon Ross <arg choice="req" rep="norepeat">filename</arg>

<arg choice="opt" rep="norepeat"><option>-p</option></arg>

<arg choice="opt" rep="norepeat"><option>-x</option></arg>

<arg choice="opt" rep="norepeat"><option>-z</option></arg>

</cmdsynopsis>

</refsynopsisdiv>

<refsection><info><title>DESCRIPTION</title></info>

<para><command>named-checkconf</command>

checks the syntax, but not the semantics, of a

<command>named</command> configuration file. The file is parsed

and checked for syntax errors, along with all files included by it.

If no file is specified, <filename>/etc/named.conf</filename> is read

by default.

</para>

<para>

Note: files that <command>named</command> reads in separate

parser contexts, such as <filename>rndc.key</filename> and

<filename>bind.keys</filename>, are not automatically read

by <command>named-checkconf</command>. Configuration

errors in these files may cause <command>named</command> to

fail to run, even if <command>named-checkconf</command> was

successful. <command>named-checkconf</command> can be run

on these files explicitly, however.

</para>

</refsection>

<refsection><info><title>OPTIONS</title></info>

<variablelist>

<varlistentry>

<term>-h</term>

<listitem>

<para>

Print the usage summary and exit.

</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>-v</term>

<listitem>

<para>

Print the version of the <command>named-checkconf</command>

program and exit.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>-p</term>

<listitem>

<para>

Print out the <filename>named.conf</filename> and included files

in canonical form if no errors were detected.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>-x</term>

<listitem>

<para>

When printing the configuration files in canonical

form, obscure shared secrets by replacing them with

strings of question marks ('?'). This allows the

contents of <filename>named.conf</filename> and related

files to be shared &mdash; for example, when submitting

bug reports &mdash; without compromising private data.

This option cannot be used without <option>-p</option>.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>-z</term>

<listitem>

<para>

Perform a test load of all master zones found in

<filename>named.conf</filename>.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>-j</term>

<listitem>

<para>

When loading a zonefile read the journal if it exists.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>filename</term>

<listitem>

<para>

The name of the configuration file to be checked. If not

specified, it defaults to <filename>/etc/named.conf</filename>.

</para>

</listitem>

</varlistentry>

</variablelist>

</refsection>

<refsection><info><title>RETURN VALUES</title></info>

<para><command>named-checkconf</command>

returns an exit status of 1 if

errors were detected and 0 otherwise.

</para>

</refsection>

<refsection><info><title>SEE ALSO</title></info>

<para><citerefentry>

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

</citerefentry>,

<citerefentry>

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

</citerefentry>,

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

</para>

</refsection>

</refentry>