Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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, /usr/lo-
       cal/etc/namedb/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 /usr/local/etc/namedb/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.6				  2020-08-10		    NAMED-CHECKCONF(8)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | RETURN VALUES | SEE ALSO | AUTHOR | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=named-checkconf&sektion=8&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help