NAMED-CHECKCONF(8)



NAMED-CHECKCONF(8)                  BIND 9                  NAMED-CHECKCONF(8)

NAME
       named-checkconf - named configuration file syntax checking tool

SYNOPSIS
       named-checkconf [-chjlvz] [-p [-x ]] [-t directory] {filename}

DESCRIPTION
       named-checkconf  checks  the  syntax, but not the semantics, of a named
       configuration file. The file is parsed and checked for  syntax  errors,
       along  with  all  files  included  by  it.  If  no  file  is specified,
       /etc/named.conf is read by default.

       Note: files that named reads  in  separate  parser  contexts,  such  as
       rndc.key  and bind.keys, are not automatically read by named-checkconf.
       Configuration errors in these files may cause named  to  fail  to  run,
       even  if named-checkconf was successful.  named-checkconf can be run on
       these files explicitly, however.

OPTIONS
       -h     Print the usage summary and exit.

       -j     When loading a zonefile read the journal if it exists.

       -l     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).

       -c     Check "core" configuration only. This suppresses the loading  of
              plugin  modules,  and causes all parameters to plugin statements
              to be ignored.

       -i     Ignore warnings on deprecated options.

       -p     Print out the named.conf and included files in canonical form if
              no errors were detected. See also the -x option.

       -t directory
              Chroot to directory so that include directives in the configura-
              tion file are processed as if run by a similarly chrooted named.

       -v     Print the version of the named-checkconf program and exit.

       -x     When printing the configuration files in canonical form, obscure
              shared  secrets by replacing them with strings of question marks
              ('?'). This allows the contents of named.conf and related  files
              to  be  shared  MDASH  for  example, when submitting bug reports
              MDASH without compromising private data. This option  cannot  be
              used without -p.

       -z     Perform a test load of all master zones found in named.conf.

       filename
              The  name of the configuration file to be checked. If not speci-
              fied, it defaults to /etc/named.conf.

RETURN VALUES
       named-checkconf returns an exit status of 1 if errors were detected and
       0 otherwise.

SEE ALSO
       named(8), named-checkzone(8), BIND 9 Administrator Reference Manual.

AUTHOR
       Internet Systems Consortium

COPYRIGHT
       2020, Internet Systems Consortium

9.16.8-Debian                     2020-10-13                NAMED-CHECKCONF(8)

Man(1) output converted with man2html
list of all man pages