summaryrefslogtreecommitdiff
path: root/examples/ldns-read-zone.1
blob: 0d77889f49c7c9b142c0b9db3aaa386630321e1a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
.TH ldns-read-zone 1 "30 May 2005"
.SH NAME
ldns-read-zone \- read a zonefile and print it
.SH SYNOPSIS
.B ldns-read-zone 
.IR ZONEFILE 

.SH DESCRIPTION

\fBldns-read-zone\fR reads a DNS zone file and prints it. The output has 1
resource record per line, and no pretty-printing makeup.

.SH OPTIONS
.TP
\fB-0\fR
Print a (null) for the RRSIG inception, expiry and key data. This option
can be used when comparing different signing systems that use the same
DNSKEYs for signing but would have a slightly different timings/jitter.

.TP
\fB-b\fR
Include Bubble Babble encoding of DS's.

.TP
\fB-c\fR
Canonicalize all resource records in the zone before printing

.TP
\fB-d\fR
Only print DNSSEC data from the zone. This option skips every record
that is not of type NSEC, NSEC3 or RRSIG. DNSKEY and DS records are not
printed.

.TP
\fB-e\fR \fIRR type\fR
Do not print RRs of the given \fIrr type\fR.
This option may be given multiple times.
\fB-e\fR is not meant to be used together with \fB-E\fR.

.TP
\fB-E\fR \fIRR type\fR
Print only RRs of the given \fIrr type\fR.
This option may be given multiple times.
\fB-E\fR is not meant to be used together with \fB-e\fR.

.TP
\fB-h\fR
Show usage and exit

.TP
\fB-n\fR
Do not print the SOA record

.TP
\fB-p\fR
Pad the SOA serial number with spaces so the number and the spaces together
take ten characters. This is useful for in file serial number increments.

.TP
\fB-s\fR
Strip DNSSEC data from the zone. This option skips every record
that is of type NSEC, NSEC3 or RRSIG. DNSKEY and DS records are still
printed.

.TP
\fB-S\fR \fI[[+|0]number | YYYYMMDDxx | unixtime ]\fR
Set serial number to the given \fInumber\fR, or when preceded by a sign,
offset the exisiting number with it. When giving the literal strings 
\fIYYYYMMDDxx\fR or \fIunixtime\fR, the serial number is tried to be reset
in datecounter or in unixtime format respectively. Though is the updated serial
number is smaller than the original one, the original one is simply
increased by one.

When updating a serial number, records of type NSEC, NSEC3, RRSIG and DNSKEY
will be skipped when printing the zone.

.TP
\fB-u\fR \fIRR type\fR
Mark \fIRR type\fR for printing in unknown type format.

\fB-u\fR is not meant to be used together with \fB-U\fR.

.TP
\fB-U\fR \fIRR type\fR
Mark \fIRR type\fR for \fBnot\fR printing in unknown type format.

The first occurrence of the \fB-U\fR option marks all RR types for printing
in unknown type format except for the given \fIRR type\fR.
Subsequent \fB-U\fR options will clear the mark for those \fIRR type\fRs too,
so that only the given \fIRR type\fRs will be printed in the presentation 
format specific for those \fIRR type\fRs.

\fB-U\fR is not meant to be used together with \fB-u\fR.

.TP
\fB-v\fR
Show the version and exit

.TP
\fB-z\fR
Sort the zone before printing (this implies \-c)


.SH AUTHOR
Written by the ldns team as an example for ldns usage.

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

.SH COPYRIGHT
Copyright (C) 2005 NLnet Labs. This is free software. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE.