xref: /netbsd-src/external/mpl/bind/dist/bin/dnssec/dnssec-verify.rst (revision e7ac2a8b5bd66fa2e050809de09a075c36a7014d)
1..
2   Copyright (C) Internet Systems Consortium, Inc. ("ISC")
3
4   This Source Code Form is subject to the terms of the Mozilla Public
5   License, v. 2.0. If a copy of the MPL was not distributed with this
6   file, You can obtain one at http://mozilla.org/MPL/2.0/.
7
8   See the COPYRIGHT file distributed with this work for additional
9   information regarding copyright ownership.
10
11..
12   Copyright (C) Internet Systems Consortium, Inc. ("ISC")
13
14   This Source Code Form is subject to the terms of the Mozilla Public
15   License, v. 2.0. If a copy of the MPL was not distributed with this
16   file, You can obtain one at http://mozilla.org/MPL/2.0/.
17
18   See the COPYRIGHT file distributed with this work for additional
19   information regarding copyright ownership.
20
21
22.. highlight: console
23
24.. _man_dnssec-verify:
25
26dnssec-verify - DNSSEC zone verification tool
27---------------------------------------------
28
29Synopsis
30~~~~~~~~
31
32:program:`dnssec-verify` [**-c** class] [**-E** engine] [**-I** input-format] [**-o** origin] [**-q**] [**-v** level] [**-V**] [**-x**] [**-z**] {zonefile}
33
34Description
35~~~~~~~~~~~
36
37``dnssec-verify`` verifies that a zone is fully signed for each
38algorithm found in the DNSKEY RRset for the zone, and that the NSEC /
39NSEC3 chains are complete.
40
41Options
42~~~~~~~
43
44**-c** class
45   Specifies the DNS class of the zone.
46
47**-E** engine
48   Specifies the cryptographic hardware to use, when applicable.
49
50   When BIND is built with OpenSSL PKCS#11 support, this defaults to the
51   string "pkcs11", which identifies an OpenSSL engine that can drive a
52   cryptographic accelerator or hardware service module. When BIND is
53   built with native PKCS#11 cryptography (--enable-native-pkcs11), it
54   defaults to the path of the PKCS#11 provider library specified via
55   "--with-pkcs11".
56
57**-I** input-format
58   The format of the input zone file. Possible formats are ``"text"``
59   (default) and ``"raw"``. This option is primarily intended to be used
60   for dynamic signed zones so that the dumped zone file in a non-text
61   format containing updates can be verified independently. The use of
62   this option does not make much sense for non-dynamic zones.
63
64**-o** origin
65   The zone origin. If not specified, the name of the zone file is
66   assumed to be the origin.
67
68**-v** level
69   Sets the debugging level.
70
71**-V**
72   Prints version information.
73
74``-q``
75   Quiet mode: Suppresses output.  Without this option, when ``dnssec-verify``
76   is run it will print to standard output the number of keys in use, the
77   algorithms used to verify the zone was signed correctly and other status
78   information.  With it, all non-error output is suppressed, and only the exit
79   code will indicate success.
80
81**-x**
82   Only verify that the DNSKEY RRset is signed with key-signing keys.
83   Without this flag, it is assumed that the DNSKEY RRset will be signed
84   by all active keys. When this flag is set, it will not be an error if
85   the DNSKEY RRset is not signed by zone-signing keys. This corresponds
86   to the ``-x`` option in ``dnssec-signzone``.
87
88**-z**
89   Ignore the KSK flag on the keys when determining whether the zone if
90   correctly signed. Without this flag it is assumed that there will be
91   a non-revoked, self-signed DNSKEY with the KSK flag set for each
92   algorithm and that RRsets other than DNSKEY RRset will be signed with
93   a different DNSKEY without the KSK flag set.
94
95   With this flag set, we only require that for each algorithm, there
96   will be at least one non-revoked, self-signed DNSKEY, regardless of
97   the KSK flag state, and that other RRsets will be signed by a
98   non-revoked key for the same algorithm that includes the self-signed
99   key; the same key may be used for both purposes. This corresponds to
100   the ``-z`` option in ``dnssec-signzone``.
101
102**zonefile**
103   The file containing the zone to be signed.
104
105See Also
106~~~~~~~~
107
108:manpage:`dnssec-signzone(8)`, BIND 9 Administrator Reference Manual, :rfc:`4033`.
109