NAME

       ldns-gen-zone - read a zonefile and print it while adding DS records and extra RR's

SYNOPSIS

       ldns-gen-zone ZONEFILE

DESCRIPTION

       ldns-gen-zone reads a DNS zone file and prints it.

       It  is  build  for  speed,  not for a nice formatting. The output has one resource record per line and no
       pretty-printing makeup.

       DNSSEC data (NSEC, NSEC3, RRSIG or DNSKEY) is not stripped. You may want to use ldns-read-zone for  that.
       Existing DS records are also not stripped.

       The  idea  is  to  use  this tool for quickly generating a representative artificial zonefile from a real
       zonefile, to use it for testing purposes.

OPTIONS

       -a NUM Adds NUM extra artificial NS RRSets to the output.  The RRSets owner names start with 'xn--' in an
              attempt  to  ensure  uniqueness  (nl.-zone does not support IDN's - and this tool was written with
              that knowledge in mind).

              An artificial NS RRSet has two NS records; ns1.example.com and ns2.example.com.

       -p NUM Add NUM% of DS RRSets to the NS RRSets (anywhere between 1-4 DS records per RRSet).

       -o ORIGIN
              Sets an $ORIGIN, which can be handy if the one in the zonefile is set to '@' for example. If there
              is an $ORIGIN in the zonefile, this option will silently be ignored.

       -s     This  is  the  recommended way of processing large zones that are already sorted and canonicalized
              (ie lowercase). It skips the sorting and canonicalization  step  that  is  required  for  properly
              grouping  RRSets  together  (before  adding  any DS records to them. Skipping this step will speed
              things up.

              It is not recommended to use this option  if  you  want  to  add  DS  records  to  unsorted,  non-
              canonicalized zones.

       -h     Show usage and exit.

       -v     Show version and exit.

EXAMPLES

       ldns-gen-zone -a 100000 -p 10 -s ./zonefile.txt
              Read  a  zonefile,  add  100.000  artificial NS RRSets and 10% of DS records, print it to standard
              output.  Don't  sort  (will  only  work  well  if  the  input  zonefile  is  already  sorted   and
              canonicalized).

       ldns-gen-zone  -p  10 -s -o nl zonefile.txt | named-compilezone -s relative -i none -o zonefile_10.txt nl
       /dev/stdin
              This creates a nicely formatted zone file with the help of  named-compilezone.   It  adds  10%  DS
              records to the .nl zone, reformats it and saves it as zonefile_10.txt.

AUTHOR

       Initially written by Marco Davids, several modifications added by Miek Gieben, both from SIDN.

REPORTING BUGS

       Report bugs to <ldns-team@nlnetlabs.nl>.

BUGS

       Only undiscovered ones.

CAVEATS

       May require a machine with a considerable amount of memory for large zone files.

       Fake  DS  records  hashes  are  generated  as  digest  type SHA-256 (RFC4509). Be aware not to change the
       DIGESTTYPE #define in the source code in anything else but 2 if you want to keep things realistic.

       Despite a number of efforts, this program is still not the fastest in the world.

COPYRIGHT

       Copyright (C) 2010 SIDN. This is free software. There is NO warranty; not  even  for  MERCHANTABILITY  or
       FITNESS FOR A PARTICULAR PURPOSE.

                                                  10 June 2010                                  ldns-gen-zone(1)