mirror of
https://gitlab.isc.org/isc-projects/bind9
synced 2025-10-25 14:59:05 +00:00
109 lines
3.3 KiB
Plaintext
109 lines
3.3 KiB
Plaintext
|
.\" Man page generated from reStructuredText.
|
||
|
|
.
|
||
|
|
.TH "NAMED-CHECKCONF" "8" "@RELEASE_DATE@" "@PACKAGE_VERSION@" "BIND 9"
|
||
|
|
.SH NAME
|
||
|
|
named-checkconf \- named configuration file syntax checking tool
|
||
|
|
.
|
||
|
|
.nr rst2man-indent-level 0
|
||
|
|
.
|
||
|
|
.de1 rstReportMargin
|
||
|
|
\\$1 \\n[an-margin]
|
||
|
|
level \\n[rst2man-indent-level]
|
||
|
|
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||
|
|
-
|
||
|
|
\\n[rst2man-indent0]
|
||
|
|
\\n[rst2man-indent1]
|
||
|
|
\\n[rst2man-indent2]
|
||
|
|
..
|
||
|
|
.de1 INDENT
|
||
|
|
.\" .rstReportMargin pre:
|
||
|
|
. RS \\$1
|
||
|
|
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
|
||
|
|
. nr rst2man-indent-level +1
|
||
|
|
.\" .rstReportMargin post:
|
||
|
|
..
|
||
|
|
.de UNINDENT
|
||
|
|
. RE
|
||
|
|
.\" indent \\n[an-margin]
|
||
|
|
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||
|
|
.nr rst2man-indent-level -1
|
||
|
|
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||
|
|
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||
|
|
..
|
||
|
|
.SH SYNOPSIS
|
||
|
|
.sp
|
||
|
|
\fBnamed\-checkconf\fP [\fB\-chjlvz\fP] [\fB\-p\fP [\fB\-x\fP ]] [\fB\-t\fP directory] {filename}
|
||
|
|
.SH DESCRIPTION
|
||
|
|
.sp
|
||
|
|
\fBnamed\-checkconf\fP checks the syntax, but not the semantics, of a
|
||
|
|
\fBnamed\fP configuration file. The file is parsed and checked for syntax
|
||
|
|
errors, along with all files included by it. If no file is specified,
|
||
|
|
\fB/etc/named.conf\fP is read by default.
|
||
|
|
.sp
|
||
|
|
Note: files that \fBnamed\fP reads in separate parser contexts, such as
|
||
|
|
\fBrndc.key\fP and \fBbind.keys\fP, are not automatically read by
|
||
|
|
\fBnamed\-checkconf\fP\&. Configuration errors in these files may cause
|
||
|
|
\fBnamed\fP to fail to run, even if \fBnamed\-checkconf\fP was successful.
|
||
|
|
\fBnamed\-checkconf\fP can be run on these files explicitly, however.
|
||
|
|
.SH OPTIONS
|
||
|
|
.INDENT 0.0
|
||
|
|
.TP
|
||
|
|
\fB\-h\fP
|
||
|
|
Print the usage summary and exit.
|
||
|
|
.TP
|
||
|
|
\fB\-j\fP
|
||
|
|
When loading a zonefile read the journal if it exists.
|
||
|
|
.TP
|
||
|
|
\fB\-l\fP
|
||
|
|
List all the configured zones. Each line of output contains the zone
|
||
|
|
name, class (e.g. IN), view, and type (e.g. master or slave).
|
||
|
|
.TP
|
||
|
|
\fB\-c\fP
|
||
|
|
Check "core" configuration only. This suppresses the loading of
|
||
|
|
plugin modules, and causes all parameters to \fBplugin\fP statements to
|
||
|
|
be ignored.
|
||
|
|
.TP
|
||
|
|
\fB\-i\fP
|
||
|
|
Ignore warnings on deprecated options.
|
||
|
|
.TP
|
||
|
|
\fB\-p\fP
|
||
|
|
Print out the \fBnamed.conf\fP and included files in canonical form if
|
||
|
|
no errors were detected. See also the \fB\-x\fP option.
|
||
|
|
.TP
|
||
|
|
\fB\-t\fP directory
|
||
|
|
Chroot to \fBdirectory\fP so that include directives in the
|
||
|
|
configuration file are processed as if run by a similarly chrooted
|
||
|
|
\fBnamed\fP\&.
|
||
|
|
.TP
|
||
|
|
\fB\-v\fP
|
||
|
|
Print the version of the \fBnamed\-checkconf\fP program and exit.
|
||
|
|
.TP
|
||
|
|
\fB\-x\fP
|
||
|
|
When printing the configuration files in canonical form, obscure
|
||
|
|
shared secrets by replacing them with strings of question marks
|
||
|
|
(\(aq?\(aq). This allows the contents of \fBnamed.conf\fP and related files
|
||
|
|
to be shared MDASH for example, when submitting bug reports MDASH
|
||
|
|
without compromising private data. This option cannot be used without
|
||
|
|
\fB\-p\fP\&.
|
||
|
|
.TP
|
||
|
|
\fB\-z\fP
|
||
|
|
Perform a test load of all master zones found in \fBnamed.conf\fP\&.
|
||
|
|
.TP
|
||
|
|
.B filename
|
||
|
|
The name of the configuration file to be checked. If not specified,
|
||
|
|
it defaults to \fB/etc/named.conf\fP\&.
|
||
|
|
.UNINDENT
|
||
|
|
.SH RETURN VALUES
|
||
|
|
.sp
|
||
|
|
\fBnamed\-checkconf\fP returns an exit status of 1 if errors were detected
|
||
|
|
and 0 otherwise.
|
||
|
|
.SH SEE ALSO
|
||
|
|
.sp
|
||
|
|
\fBnamed(8)\fP, \fBnamed\-checkzone(8)\fP, BIND 9 Administrator Reference Manual.
|
||
|
|
.SH AUTHOR
|
||
|
|
Internet Systems Consortium
|
||
|
|
.SH COPYRIGHT
|
||
|
|
2020, Internet Systems Consortium
|
||
|
|
.\" Generated by docutils manpage writer.
|
||
|
|
.
|