nsd-checkzone(8)                  nsd 4.11.1                  nsd-checkzone(8)

NAME
       nsd-checkzone - NSD zone file syntax checker.

SYNOPSIS
       nsd-checkzone [-h] zonename zonefile

DESCRIPTION
       nsd-checkzone  reads  a  DNS  zone  file  and checks it for errors.  It
       prints errors to stderr.  On failure it exits with nonzero exit status.

       This is used to check files before feeding them to the nsd(8) daemon.

OPTIONS
       -h     Print usage help information and exit.

       zonename
              The name of the zone to check, eg. "example.com".

       zonefile
              The file to read, eg. "zones/example.com.zone.signed".  Use  "-"
              to read from stdin.

       -p     Print the zone contents to stdout if the zone is ok. This prints
              the  contents as it has been parsed, not literally a copy of the
              input, but as printed by the formatting routines  in  NSD,  much
              like the nsd-control command write does.

       -i <oldzonefile>
              Create  an  IXFR  from the differences between the old zone file
              and the new zone file. The argument to the -i option is the  old
              zone  file,  the other zonefile argument passed is the new zone-
              file.

              The difference is computed between the two zonefiles by  keeping
              one version of the zone in memory, and another version in a tem-
              porary  file.  The temporary file is located at the zonefile di-
              rectory. This is also where the result is  written,  to  a  file
              with  the zonefile name, ending with '.ixfr'. This is also where
              NSD reads it when IXFRs are configured for the zone.

              The other existing ixfr files are renamed to become  older  IXFR
              contents  for  the zone, if any such files exist.  If the output
              file already exists with the correct contents, no  new  file  is
              created.  The  contents  of  the  header  of the output file are
              checked for that, if it already exists.

       -n <ixfr number>
              The number of IXFR versions to store, at most. Default  5.  This
              is  the  number  of files that is created with ixfr contents for
              the zone. Older stored IXFR versions are deleted when the number
              is exceeded.

       -s <ixfr size>
              The number of bytes of storage to  use  for  IXFRs.  Default  is
              1048576.  If an IXFR is bigger it is not created, and if the sum
              of IXFR storage exceeds it, older IXFRs versions are deleted.

SEE ALSO
       nsd(8), nsd-checkconf(8)

AUTHORS
       NSD was written by NLnet Labs and RIPE NCC joint team. Please see CRED-
       ITS file in the distribution for further details.

NLnet Labs                       jan 18, 2025                 nsd-checkzone(8)