named-checkzone, named-compilezone Commands

Edit online

Purpose

Checks zone file validity or converts tool of a named configuration file.

Syntax

named-checkzone [ -d ] [ -j ] [ -q ] [ -v ] [ -c class ] [ -f format ] [ -F format ] [ -i mode ] [ -k mode ] [ -m mode ] [ -M mode ] [ -n mode ] [ -o filename ] [ -s style ] [ -S mode ] [ -t directory ] [ -w directory ] [ -D ] [ -W mode ] zonename filename named-compilezone [ -d ] [ -j ] [ -q ] [ -v ] [ -c class ] [ -f format ] [ -F format ] [ -i mode] [ -k mode ] [ -m mode ] [ -n mode ] [ -o filename ] [ -s style ] [ -t directory ] [ -w directory ] [ -D ] [ -W mode ] zonename filename

Description

The named-checkzone command checks the syntax and integrity of a zone file. The checks are same as the checks of the named daemon checks when loading a zone. This makes the named-checkzone command useful to check zone files before you configure them into a name server.

The named-compilezone command is similar to the named-checkzone command. The named-compilezone command always dumps the zone contents to a specified file in a specified format. Also, it applies stricter check levels by default, since the dump output is used as an actual zone file that the named daemon loads. When manually specified otherwise, the check levels must at least be as strict as the checks specified in the named configuration file.

Flags

Table 1. Flags
Item Description
-c class Specifies the class of the zone. If not specified, the class is set to IN by default.
-d Enables debugging.
-D Dumps zone file in a canonical format and is always enabled for the named-compilezone command.
-i mode Checks post load zone integrity. The mode parameter can be one of the following values:
full
Checks if MX records, SRV records, and delegation NS records refer to A or AAAA record, both in-zone and out-of-zone hostnames. It checks whether glue addresses records in the zone match those advertised by the child.
full-sibling
Disables sibling glue checks but is otherwise the same as mode full.
local
Check only whether MX records, SRV records, and the delegation NS records refer to in-zone host names or if some required glue exists, that is when the name server is in a child zone.
local-sibling
Disables sibling glue checks but is otherwise the same as mode local.
none
Disables the checks.
-j Reads the journal if it exists when loading the zone file.
-f format Specifies the format of the zone file. Possible formats are text and raw. The default format is text.
-F format Specifies the format of the output file specified. Possible formats are text and raw. This flag does not cause any effects unless it dumps the zone contents. The default format is text.
-k mode Performs check-names checks with the specified failure mode. Possible modes are fail, warn, and ignore. The default mode is warn.
-m mode Specifies whether MX records must be checked to see whether they are addresses. Possible modes are fail, warn, and ignore. The default mode is warn.
-M mode Checks if an MX record refers to a CNAME. Possible modes are fail, warn, and ignore. The default mode is warn.
-n mode Specifies whether NS records must be checked to see whether they are addresses. Possible modes are fail, warn, and ignore. The default mode is warn.
-o filename Writes zone output to the file that the filename value specifies.
-q Indicates quiet mode (exits code only).
-s style Specifies the style of the dumped zone file. Possible styles are full and relative. The default style is full. The full format is most suitable to process automatically by a separate script. The relative format is more human-readable and is suitable to edit by hand. This flag does not cause any effects unless it dumps the zone contents. It also does not have any meaning if the output format is not text.
-S mode Checks if an SRV record refers to a CNAME. Possible modes are fail, warn, and ignore. The default mode is warn.
-t directory Changes the directory to the directory. The directives that are included in the configuration file are processed.
-v Prints the version of the named-checkzone command and exits.
-w directory Changes the current directory to the directory. The relative file names in the master file $INCLUDE directives work. This is similar to the directory clause in the named.conf file.
-W mode Specifies whether to check for nonterminal wildcards. Nonterminal wildcards are almost always the result of a failure to understand the wildcard matching algorithm (RFC 1034). Possible modes are warn and ignore. The default mode is warn
zonename Specifies the domain name of the zone that is checked.
filename Specifies the name of the zone file.

Exit status

Table 2. Exit status
Item Description
0 Indicates a successful completion.
1 Indicates errors.

named-checkzone, named-compilezone command - BIND 9.18

For a complete description, see named-checkzone, named-compilezone command in the BIND 9.18 Administrator Reference Manual.