summaryrefslogtreecommitdiff
path: root/examples/ldns-verify-zone.1.in
blob: 2cee807f250c76e37011cb8a78f285ba71dace05 (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
.TH ldns-verifyzone 1 "27 May 2008"
.SH NAME
ldns-verify-zone \- read a DNSSEC signed zone and verify it.
.SH SYNOPSIS
.B ldns-verify-zone 
.IR ZONEFILE 

.SH DESCRIPTION

\fBldns-verify-zone\fR reads a DNS zone file and verifies it. 

RRSIG resource records are checked against the DNSKEY set at the zone apex.

Each name is checked for an NSEC(3), if appropriate.

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

.TP
\fB-a\fR
Apex only, check only the zone apex

.TP
\fB-e\fR \fIperiod\fR
Signatures may not expire within this period.
Default no period is used.

.TP
\fB-i\fR \fIperiod\fR
Signatures must have been valid at least this long.
Default signatures should just be valid now.

.TP
\fB-k\fR \fIfile\fR
A file that contains a trusted DNSKEY or DS rr.
This option may be given more than once.

Alternatively, if \fB-k\fR is not specified, and a default trust anchor
(@LDNS_TRUST_ANCHOR_FILE@) exists and contains a valid DNSKEY or DS record,
it will be used as the trust anchor.
.TP
\fB-p\fR \fI[0-100]\fR
Only check this percentage of the zone.
Which names to check is determined randomly.
Defaults to 100.

.TP
\fB-S\fR
Chase signature(s) to a known key.
The network may be accessed to validate the zone's DNSKEYs. (implies \-k)

.TP
\fB-t\fR \fIYYYYMMDDhhmmss | [+|-]offset\fR
Set the validation time either by an absolute time value or as an offset in seconds from the current time.

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

.TP
\fB-V\fR \fInumber\fR
Set the verbosity level (default 3):

 0: Be silent
 1: Print result, and any errors
 2: Same as 1 for now
 3: Print result, any errors, and the names that are
    being checked
 4: Same as 3 for now
 5: Print the zone after it has been read, the result, 
    any errors, and the names that are being checked

.LP
\fIperiod\fRs are given in ISO 8601 duration format:
.RS
P[n]Y[n]M[n]DT[n]H[n]M[n]S
.RE
.LP
If no file is given standard input is read.

.SH "FILES"
.TP
@LDNS_TRUST_ANCHOR_FILE@
The file from which trusted keys are loaded for signature chasing,
when no \fB-k\fR option is given.

.SH "SEE ALSO"
.LP
unbound-anchor(8)

.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) 2008 NLnet Labs. This is free software. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE.