Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ldns-gen-zone(1)	    General Commands Manual	      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  pur-
       poses.

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	 zone-
	      file, 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	rela-
       tive -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,  re-
	      formats 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 <dns-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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ldns-gen-zone&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help