1nsd-checkzone(8)                   nsd 4.7.0                  nsd-checkzone(8)
2
3
4

NAME

6       nsd-checkzone - NSD zone file syntax checker.
7

SYNOPSIS

9       nsd-checkzone [-h] zonename zonefile
10

DESCRIPTION

12       nsd-checkzone  reads  a  DNS  zone  file  and checks it for errors.  It
13       prints errors to stderr.  On failure it exits with nonzero exit status.
14
15       This is used to check files before feeding them to the nsd(8) daemon.
16

OPTIONS

18       -h     Print usage help information and exit.
19
20       zonename
21              The name of the zone to check, eg. "example.com".
22
23       zonefile
24              The file to read, eg. "zones/example.com.zone.signed".
25
26       -p     Print the zone contents to stdout if the zone is ok. This prints
27              the  contents as it has been parsed, not literally a copy of the
28              input, but as printed by the formatting routines  in  NSD,  much
29              like the nsd-control command write does.
30
31       -i <oldzonefile>
32              Create  an  IXFR  from the differences between the old zone file
33              and the new zone file. The argument to the -i option is the  old
34              zone  file,  the other zonefile argument passed is the new zone‐
35              file.
36
37              The difference is computed between the two zonefiles by  keeping
38              one version of the zone in memory, and another version in a tem‐
39              porary file. The temporary file is located at the  zonefile  di‐
40              rectory.  This  is  also  where the result is written, to a file
41              with the zonefile name, ending with '.ixfr'. This is also  where
42              NSD reads it when IXFRs are configured for the zone.
43
44              The  other  existing ixfr files are renamed to become older IXFR
45              contents for the zone, if any such files exist.  If  the  output
46              file  already  exists  with the correct contents, no new file is
47              created. The contents of the  header  of  the  output  file  are
48              checked for that, if it already exists.
49
50       -n <ixfr number>
51              The  number  of IXFR versions to store, at most. Default 5. This
52              is the number of files that is created with  ixfr  contents  for
53              the zone. Older stored IXFR versions are deleted when the number
54              is exceeded.
55
56       -s <ixfr size>
57              The number of bytes of storage to  use  for  IXFRs.  Default  is
58              1048576.  If an IXFR is bigger it is not created, and if the sum
59              of IXFR storage exceeds it, older IXFRs versions are deleted.
60

SEE ALSO

62       nsd(8), nsd-checkconf(8)
63

AUTHORS

65       NSD was written by NLnet Labs and RIPE NCC joint team. Please see CRED‐
66       ITS file in the distribution for further details.
67
68
69
70NLnet Labs                       Jun  7, 2023                 nsd-checkzone(8)