"Fossies" - the Fresh Open Source Software Archive

Member "bind-9.17.5/doc/man/named-checkconf.1in" (4 Sep 2020, 3674 Bytes) of package /linux/misc/dns/bind9/9.17.5/bind-9.17.5.tar.xz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. See also the last Fossies "Diffs" side-by-side code changes report for "named-checkconf.1in": 9.17.2_vs_9.17.3.

    1 .\" Man page generated from reStructuredText.
    2 .
    3 .TH "NAMED-CHECKCONF" "1" "@RELEASE_DATE@" "@PACKAGE_VERSION@" "BIND 9"
    4 .SH NAME
    5 named-checkconf \- named configuration file syntax checking tool
    6 .
    7 .nr rst2man-indent-level 0
    8 .
    9 .de1 rstReportMargin
   10 \\$1 \\n[an-margin]
   11 level \\n[rst2man-indent-level]
   12 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
   13 -
   14 \\n[rst2man-indent0]
   15 \\n[rst2man-indent1]
   16 \\n[rst2man-indent2]
   17 ..
   18 .de1 INDENT
   19 .\" .rstReportMargin pre:
   20 . RS \\$1
   21 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
   22 . nr rst2man-indent-level +1
   23 .\" .rstReportMargin post:
   24 ..
   25 .de UNINDENT
   26 . RE
   27 .\" indent \\n[an-margin]
   28 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
   29 .nr rst2man-indent-level -1
   30 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
   31 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
   32 ..
   33 .SH SYNOPSIS
   34 .sp
   35 \fBnamed\-checkconf\fP [\fB\-chjlvz\fP] [\fB\-p\fP [\fB\-x\fP ]] [\fB\-t\fP directory] {filename}
   36 .SH DESCRIPTION
   37 .sp
   38 \fBnamed\-checkconf\fP checks the syntax, but not the semantics, of a
   39 \fBnamed\fP configuration file. The file, along with all files included by it, is parsed and checked for syntax
   40 errors. If no file is specified,
   41 \fB/etc/named.conf\fP is read by default.
   42 .sp
   43 Note: files that \fBnamed\fP reads in separate parser contexts, such as
   44 \fBrndc.key\fP and \fBbind.keys\fP, are not automatically read by
   45 \fBnamed\-checkconf\fP\&. Configuration errors in these files may cause
   46 \fBnamed\fP to fail to run, even if \fBnamed\-checkconf\fP was successful.
   47 However, \fBnamed\-checkconf\fP can be run on these files explicitly.
   48 .SH OPTIONS
   49 .INDENT 0.0
   50 .TP
   51 .B \fB\-h\fP
   52 This option prints the usage summary and exits.
   53 .TP
   54 .B \fB\-j\fP
   55 When loading a zonefile, this option instructs \fBnamed\fP to read the journal if it exists.
   56 .TP
   57 .B \fB\-l\fP
   58 This option lists all the configured zones. Each line of output contains the zone
   59 name, class (e.g. IN), view, and type (e.g. primary or secondary).
   60 .TP
   61 .B \fB\-c\fP
   62 This option specifies that only the "core" configuration should be checked. This suppresses the loading of
   63 plugin modules, and causes all parameters to \fBplugin\fP statements to
   64 be ignored.
   65 .TP
   66 .B \fB\-i\fP
   67 This option ignores warnings on deprecated options.
   68 .TP
   69 .B \fB\-p\fP
   70 This option prints out the \fBnamed.conf\fP and included files in canonical form if
   71 no errors were detected. See also the \fB\-x\fP option.
   72 .TP
   73 .B \fB\-t directory\fP
   74 This option instructs \fBnamed\fP to chroot to \fBdirectory\fP, so that \fBinclude\fP directives in the
   75 configuration file are processed as if run by a similarly chrooted
   76 \fBnamed\fP\&.
   77 .TP
   78 .B \fB\-v\fP
   79 This option prints the version of the \fBnamed\-checkconf\fP program and exits.
   80 .TP
   81 .B \fB\-x\fP
   82 When printing the configuration files in canonical form, this option obscures
   83 shared secrets by replacing them with strings of question marks
   84 (\fB?\fP). This allows the contents of \fBnamed.conf\fP and related files
   85 to be shared \- for example, when submitting bug reports \-
   86 without compromising private data. This option cannot be used without
   87 \fB\-p\fP\&.
   88 .TP
   89 .B \fB\-z\fP
   90 This option performs a test load of all zones of type \fBprimary\fP found in \fBnamed.conf\fP\&.
   91 .TP
   92 .B \fBfilename\fP
   93 This indicates the name of the configuration file to be checked. If not specified,
   94 it defaults to \fB/etc/named.conf\fP\&.
   95 .UNINDENT
   96 .SH RETURN VALUES
   97 .sp
   98 \fBnamed\-checkconf\fP returns an exit status of 1 if errors were detected
   99 and 0 otherwise.
  100 .SH SEE ALSO
  101 .sp
  102 \fBnamed(8)\fP, \fBnamed\-checkzone(8)\fP, BIND 9 Administrator Reference Manual.
  103 .SH AUTHOR
  104 Internet Systems Consortium
  105 .SH COPYRIGHT
  106 2020, Internet Systems Consortium
  107 .\" Generated by docutils manpage writer.
  108 .