local-unbound-checkconf(8)

local-unbound-checkconf8

Check local-unbound 1.26.2 configuration file for errors.

Usage

unbound-checkconf [-hf] [-o option] [cfgfile]

Overview

unbound-checkconf checks the configuration file for the local-unbound(8) DNS resolver for syntax and other errors. The config file syntax is described in unbound.conf(5).

The available options are:

-h

Show the version and commandline option help.

-f

Print full pathname, with chroot applied to it. Use with the -o option.

-q

Make the operation quiet, suppress output on success.

-o <option>

If given, after checking the config file the value of this option is printed to stdout. For "" (disabled) options an empty line is printed.

cfgfile

The config file to read with settings for Unbound. It is checked. If omitted, the config file at the default location is checked.

Exit code

The unbound-checkconf program exits with status code 1 on error, 0 for a correct config file.

Files

/var/unbound/unbound.conf

Local-unbound configuration file.

Releases

21 releases since FreeBSD 11.4-RELEASE; the text changed 10 times.

  1. 11.4
  2. 12.0–12.1
  3. 12.2–12.3
  4. 12.4
  5. 13.0
  6. 13.1–14.3
  7. 14.4
  8. 14.5
  9. 15.0
  10. 15.1
  11. 16.0

-q since FreeBSD 14.4-RELEASE.

Author

Local-unbound developers are mentioned in the CREDITS file in the distribution.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's man source.