1ldns-gen-zone(1)            General Commands Manual           ldns-gen-zone(1)
2
3
4

NAME

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

SYNOPSIS

10       ldns-gen-zone ZONEFILE
11
12

DESCRIPTION

14       ldns-gen-zone reads a DNS zone file and prints it.
15
16       It is build for speed, not for a nice formatting. The  output  has  one
17       resource record per line and no pretty-printing makeup.
18
19       DNSSEC  data  (NSEC,  NSEC3,  RRSIG or DNSKEY) is not stripped. You may
20       want to use ldns-read-zone for that. Existing DS records are  also  not
21       stripped.
22
23       The  idea  is  to use this tool for quickly generating a representative
24       artificial zonefile from a real zonefile, to use it  for  testing  pur‐
25       poses.
26
27

OPTIONS

29       -a NUM Adds  NUM  extra artificial NS RRSets to the output.  The RRSets
30              owner names start with 'xn--' in an attempt to ensure uniqueness
31              (nl.-zone  does  not  support  IDN's - and this tool was written
32              with that knowledge in mind).
33
34              An artificial NS RRSet has two NS records;  ns1.example.com  and
35              ns2.example.com.
36
37
38       -p NUM Add  NUM% of DS RRSets to the NS RRSets (anywhere between 1-4 DS
39              records per RRSet).
40
41
42       -o ORIGIN
43              Sets an $ORIGIN, which can be handy if the one in  the  zonefile
44              is  set  to '@' for example. If there is an $ORIGIN in the zone‐
45              file, this option will silently be ignored.
46
47
48       -s     This is the recommended way of processing large zones  that  are
49              already  sorted  and  canonicalized (ie lowercase). It skips the
50              sorting and canonicalization step that is required for  properly
51              grouping  RRSets together (before adding any DS records to them.
52              Skipping this step will speed things up.
53
54              It is not recommended to use this option if you want to  add  DS
55              records to unsorted, non-canonicalized zones.
56
57
58       -h     Show usage and exit.
59
60
61       -v     Show version and exit.
62
63

EXAMPLES

65       ldns-gen-zone -a 100000 -p 10 -s ./zonefile.txt
66              Read  a zonefile, add 100.000 artificial NS RRSets and 10% of DS
67              records, print it to standard output. Don't sort (will only work
68              well if the input zonefile is already sorted and canonicalized).
69
70
71       ldns-gen-zone  -p 10 -s -o nl zonefile.txt | named-compilezone -s rela‐
72       tive -i none -o zonefile_10.txt nl /dev/stdin
73              This creates a nicely formatted  zone  file  with  the  help  of
74              named-compilezone.   It  adds  10%  DS  records to the .nl zone,
75              reformats it and saves it as zonefile_10.txt.
76
77

AUTHOR

79       Initially written by Marco Davids, several modifications added by  Miek
80       Gieben, both from SIDN.
81
82

REPORTING BUGS

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

BUGS

88       Only undiscovered ones.
89
90

CAVEATS

92       May  require  a  machine with a considerable amount of memory for large
93       zone files.
94
95       Fake DS records hashes are generated as digest type SHA-256  (RFC4509).
96       Be  aware  not  to  change the DIGESTTYPE #define in the source code in
97       anything else but 2 if you want to keep things realistic.
98
99       Despite a number of efforts, this program is still not the  fastest  in
100       the world.
101
102

104       Copyright  (C)  2010 SIDN. This is free software. There is NO warranty;
105       not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
106
107
108
109                                 10 June 2010                 ldns-gen-zone(1)
Impressum