nsd-checkzone(8)                  nsd 4.10.0                  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".

       -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                       Jun 13, 2024                 nsd-checkzone(8)