1NAMED-CHECKCONF(1)                  BIND 9                  NAMED-CHECKCONF(1)
2
3
4

NAME

6       named-checkconf - named configuration file syntax checking tool
7

SYNOPSIS

9       named-checkconf [-achjlvz] [-p [-x ]] [-t directory] {filename}
10

DESCRIPTION

12       named-checkconf  checks  the  syntax, but not the semantics, of a named
13       configuration file. The file, along with all files included by  it,  is
14       parsed  and  checked  for  syntax  errors.  If  no  file  is specified,
15       /etc/named.conf is read by default.
16
17       Note: files that named reads  in  separate  parser  contexts,  such  as
18       rndc.conf  or  rndc.key, are not automatically read by named-checkconf.
19       Configuration errors in these files may cause named  to  fail  to  run,
20       even  if  named-checkconf was successful.  However, named-checkconf can
21       be run on these files explicitly.
22

OPTIONS

24       -a     Don't check the dnssec-policy's DNSSEC  key  algorithms  against
25              those  supported  by  the  crypto provider.  This is useful when
26              checking a named.conf intended to be run on another machine with
27              possibly a different set of supported DNSSEC key algorithms.
28
29       -h     This option prints the usage summary and exits.
30
31       -j     When loading a zonefile, this option instructs named to read the
32              journal if it exists.
33
34       -l     This option lists all the configured zones. Each line of  output
35              contains  the  zone  name, class (e.g. IN), view, and type (e.g.
36              primary or secondary).
37
38       -c     This option specifies that only the "core" configuration  should
39              be  checked.  This suppresses the loading of plugin modules, and
40              causes all parameters to plugin statements to be ignored.
41
42       -i     This option ignores warnings on deprecated options.
43
44       -p     This option prints out the  named.conf  and  included  files  in
45              canonical  form  if no errors were detected. See also the -x op‐
46              tion.
47
48       -t directory
49              This option instructs named to chroot to directory, so that  in‐
50              clude  directives  in the configuration file are processed as if
51              run by a similarly chrooted named.
52
53       -v     This option prints the version of  the  named-checkconf  program
54              and exits.
55
56       -x     When  printing  the  configuration files in canonical form, this
57              option obscures shared secrets by replacing them with strings of
58              question  marks  (?). This allows the contents of named.conf and
59              related files to be shared - for example,  when  submitting  bug
60              reports  - without compromising private data. This option cannot
61              be used without -p.
62
63       -z     This option performs a test load of all zones  of  type  primary
64              found in named.conf.
65
66       filename
67              This indicates the name of the configuration file to be checked.
68              If not specified, it defaults to /etc/named.conf.
69

RETURN VALUES

71       named-checkconf returns an exit status of 1 if errors were detected and
72       0 otherwise.
73

SEE ALSO

75       named(8), named-checkzone(8), BIND 9 Administrator Reference Manual.
76

AUTHOR

78       Internet Systems Consortium
79

81       2023, Internet Systems Consortium
82
83
84
85
869.19.18                                                     NAMED-CHECKCONF(1)
Impressum