named-checkconf.docbook revision a7c412f37cc73d0332887a746e81220cbf09dd00
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
7d9d170dbb323f18be252b99690be0d95c565141Automatic Updater "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
499b34cea04a46823d003d4c0520c8b03e8513cbBrian Wellington [<!ENTITY mdash "—">]>
ec5347e2c775f027573ce5648b910361aa926c01Automatic Updater - Copyright (C) 2004, 2005, 2007, 2009, 2014 Internet Systems Consortium, Inc. ("ISC")
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson - Copyright (C) 2000-2002 Internet Software Consortium.
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence - Permission to use, copy, modify, and/or distribute this software for any
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - purpose with or without fee is hereby granted, provided that the above
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - copyright notice and this permission notice appear in all copies.
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
adbc1771946365942cc149f6130c36f3aca44fb8Automatic Updater - PERFORMANCE OF THIS SOFTWARE.
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson<!-- $Id: named-checkconf.docbook,v 1.22 2009/12/28 23:21:16 each Exp $ -->
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson <refentryinfo>
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson </refentryinfo>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein <refentrytitle><application>named-checkconf</application></refentrytitle>
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson <holder>Internet Software Consortium.</holder>
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson <refname><application>named-checkconf</application></refname>
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson <refpurpose>named configuration file syntax checking tool</refpurpose>
dd2a0a6d2dec1c23787351e51b434a838dec5603Evan Hunt </refnamediv>
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson <refsynopsisdiv>
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson <arg><option>-t <replaceable class="parameter">directory</replaceable></option></arg>
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson </cmdsynopsis>
6d12fdf96621801e80f3f4c2a8a569fe48766a20David Lawrence </refsynopsisdiv>
70c7f4fb4fc589b04a68d67479d34eecd99c1991Evan Hunt checks the syntax, but not the semantics, of a
70c7f4fb4fc589b04a68d67479d34eecd99c1991Evan Hunt <command>named</command> configuration file. The file is parsed
70c7f4fb4fc589b04a68d67479d34eecd99c1991Evan Hunt and checked for syntax errors, along with all files included by it.
70c7f4fb4fc589b04a68d67479d34eecd99c1991Evan Hunt If no file is specified, <filename>/etc/named.conf</filename> is read
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein Note: files that <command>named</command> reads in separate
70c7f4fb4fc589b04a68d67479d34eecd99c1991Evan Hunt parser contexts, such as <filename>rndc.key</filename> and
70c7f4fb4fc589b04a68d67479d34eecd99c1991Evan Hunt <filename>bind.keys</filename>, are not automatically read
70c7f4fb4fc589b04a68d67479d34eecd99c1991Evan Hunt by <command>named-checkconf</command>. Configuration
70c7f4fb4fc589b04a68d67479d34eecd99c1991Evan Hunt errors in these files may cause <command>named</command> to
70c7f4fb4fc589b04a68d67479d34eecd99c1991Evan Hunt fail to run, even if <command>named-checkconf</command> was
70c7f4fb4fc589b04a68d67479d34eecd99c1991Evan Hunt successful. <command>named-checkconf</command> can be run
70c7f4fb4fc589b04a68d67479d34eecd99c1991Evan Hunt on these files explicitly, however.
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson <variablelist>
70c7f4fb4fc589b04a68d67479d34eecd99c1991Evan Hunt <varlistentry>
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson Print the usage summary and exit.
7781f25078c491a9650dec555bdc86cb0ed49861Tatuya JINMEI 神明達哉 </varlistentry>
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson <varlistentry>
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson <term>-t <replaceable class="parameter">directory</replaceable></term>
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson Chroot to <filename>directory</filename> so that include
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson directives in the configuration file are processed as if
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson run by a similarly chrooted named.
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson </varlistentry>
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson <varlistentry>
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson Print the version of the <command>named-checkconf</command>
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson program and exit.
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson </varlistentry>
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson <varlistentry>
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson Print out the <filename>named.conf</filename> and included files
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson in canonical form if no errors were detected.
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein </varlistentry>
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson <varlistentry>
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson When printing the configuration files in canonical
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson form, obscure shared secrets by replacing them with
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson strings of question marks ('?'). This allows the
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein contents of <filename>named.conf</filename> and related
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson files to be shared — for example, when submitting
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein bug reports — without compromising private data.
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein This option cannot be used without <option>-p</option>.
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson </varlistentry>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein <varlistentry>
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson Perform a test load of all master zones found in
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence </varlistentry>
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence <varlistentry>
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson When loading a zonefile read the journal if it exists.
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein </varlistentry>
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson <varlistentry>
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson The name of the configuration file to be checked. If not
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson specified, it defaults to <filename>/etc/named.conf</filename>.
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein </varlistentry>
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson </variablelist>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein returns an exit status of 1 if
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson errors were detected and 0 otherwise.
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson <refentrytitle>named</refentrytitle><manvolnum>8</manvolnum>
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson </citerefentry>,
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson <citerefentry>
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein <refentrytitle>named-checkzone</refentrytitle><manvolnum>8</manvolnum>
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson </citerefentry>,
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson <citetitle>BIND 9 Administrator Reference Manual</citetitle>.
f951f076f3d321c52b824a866caff28ce4f8e06cAndreas Gustafsson <para><corpauthor>Internet Systems Consortium</corpauthor>
9b0e18da3d5c2290f90b285d122d368173f17c63Andreas Gustafsson - Local variables: