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 <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)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | AUTHOR | REPORTING BUGS | BUGS | CAVEATS | COPYRIGHT

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

home | help