1NAMED-CHECKCONF(8)                   BIND9                  NAMED-CHECKCONF(8)
2
3
4

NAME

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

SYNOPSIS

9       named-checkconf [-hjvz] [-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 is parsed and checked for syntax errors,
14       along with all files included by it. 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.  named-checkconf can be run on
21       these files explicitly, however.
22

OPTIONS

24       -h
25           Print the usage summary and exit.
26
27       -j
28           When loading a zonefile read the journal if it exists.
29
30       -p
31           Print out the named.conf and included files in canonical form if no
32           errors were detected. See also the -x option.
33
34       -t directory
35           Chroot to directory so that include directives in the configuration
36           file are processed as if run by a similarly chrooted named.
37
38       -v
39           Print the version of the named-checkconf program and exit.
40
41       -x
42           When printing the configuration files in canonical form, obscure
43           shared secrets by replacing them with strings of question marks
44           ('?'). This allows the contents of named.conf and related files to
45           be shared — for example, when submitting bug reports — without
46           compromising private data. This option cannot be used without -p.
47
48       -z
49           Perform a test load of all master zones found in named.conf.
50
51       filename
52           The name of the configuration file to be checked. If not specified,
53           it defaults to /etc/named.conf.
54

RETURN VALUES

56       named-checkconf returns an exit status of 1 if errors were detected and
57       0 otherwise.
58

SEE ALSO

60       named(8), named-checkzone(8), BIND 9 Administrator Reference Manual.
61

AUTHOR

63       Internet Systems Consortium, Inc.
64

66       Copyright © 2000-2002, 2004, 2005, 2007, 2009, 2014-2016, 2018-2021
67       Internet Systems Consortium, Inc. ("ISC")
68
69
70
71ISC                               2014-01-10                NAMED-CHECKCONF(8)
Impressum