CentOS 7.0 - man page for ldns-gen-zone (centos section 1)

ldns-gen-zone(1)								 ldns-gen-zone(1)

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 zone-
       file_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 MER-
       CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

					   10 June 2010 			 ldns-gen-zone(1)