'\" t
.\"     dnsutl - utilities to make DNS easier to configure
.\"     Copyright (C) 1999, 2000, 2007 Peter Miller
.\"
.\"     This program is free software; you can redistribute it and/or modify
.\"     it under the terms of the GNU General Public License as published by
.\"     the Free Software Foundation; either version 3 of the License, or
.\"     (at your option) any later version.
.\"
.\"     This program is distributed in the hope that it will be useful,
.\"     but WITHOUT ANY WARRANTY; without even the implied warranty of
.\"     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\"     GNU General Public License for more details.
.\"
.\"     You should have received a copy of the GNU General Public License
.\"     along with this program. If not, see
.\"     <http://www.gnu.org/licenses/>.
.\"
.ds n) dns-boot-check
.TH \*(n) 1
.SH NAME
dns-boot-check \- check /etc/named.boot file
.XX "dns-boot-check(1)" "check /etc/named.boot file"
.SH SYNOPSIS
.B \*(n)
[
.IR option \&...
]
.IR filename
.br
.B \*(n)
.B -Help
.br
.B \*(n)
.B -VERSion
.SH DESCRIPTION
The \fI\*(n)\fP program is used to check the \fInamed\fP(8) configuration
file for correctness.  It checks for things like the forwards and
backwards mappings exactly corresponding, and for the name server records
all having address records.
.PP
The filename on the command line is the file to be checked.
It defaults to \fI/etc/named.boot\fP if not specified.
.PP
Suggestions for additional checks that \fI\*(n)\fP(1) could perform are
most welcome.
.br
.ne 1i
.SH OPTIONS
The following options are understood:
.TP 8n
.B -Help
.br
Provide some help with using the
.I \*(n)
program.
.TP 8n
\fB-I\fP\fIdirectory\fP
This option may be used to specify a directory to search for include
files.  It may be used more than once, the directories will be searched
in the order given.
.TP 8n
.B -VERSion
.br
Print the version of the
.I \*(n)
program being executed.
.PP
All other options will produce a diagnostic error.
.so arglex.so
.so exit.so
.SH EXAMPLES
To check your \fInamed\fP(8) configuration, you need only say
.RS
\*(n)
.RE
and the file \fInamed\fP(8) configuration file will be read, and also
all of the files it refers to.  Various cross checks will be made between
the files, too.
.PP
If you want to check a \fInamed\fP(8)
configuration, but without installing it first (which can be important
if you need to guarantee continuity of service) put you new configuration
files together in a temporary directory, with relative paths.
.RS
\*(n) -I. etc/named.boot
.RE
This will access all of the files as if they were below "." (the current
directory) rather than absolute.  This can simplify configuration
management issues, too.
.PP
Suggestions for additional checks that \fI\*(n)\fP(1) could perform are
most welcome.
.so copyright.so
.so author.so