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

RETURN VALUES

66       named-checkconf returns an exit status of 1 if errors were detected and
67       0 otherwise.
68

SEE ALSO

70       named(8), named-checkzone(8), BIND 9 Administrator Reference Manual.
71

AUTHOR

73       Internet Systems Consortium
74

76       2023, Internet Systems Consortium
77
78
79
80
819.18.11                                                     NAMED-CHECKCONF(1)
Impressum