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 https://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 39NSEC/NSEC3 chains are complete. 40 41Options 42~~~~~~~ 43 44``-c class`` 45 This option specifies the DNS class of the zone. 46 47``-E engine`` 48 This option specifies the cryptographic hardware to use, when applicable. 49 50 When BIND 9 is built with OpenSSL, this needs to be set to the OpenSSL 51 engine identifier that drives the cryptographic accelerator or 52 hardware service module (usually ``pkcs11``). 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 This option sets the format of the input zone file. Possible formats are ``text`` 59 (the 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. 62 This option is not useful for non-dynamic zones. 63 64``-o origin`` 65 This option indicates the zone origin. If not specified, the name of the zone file is 66 assumed to be the origin. 67 68``-v level`` 69 This option sets the debugging level. 70 71``-V`` 72 This option prints version information. 73 74``-q`` 75 This option sets quiet mode, which suppresses output. Without this option, when ``dnssec-verify`` 76 is run it prints 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 this option, all non-error output is suppressed, and only the exit 79 code indicates success. 80 81``-x`` 82 This option verifies only that the DNSKEY RRset is signed with key-signing keys. 83 Without this flag, it is assumed that the DNSKEY RRset is signed 84 by all active keys. When this flag is set, it is not 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 This option indicates that the KSK flag on the keys should be ignored when determining whether the zone is 90 correctly signed. Without this flag, it is assumed that there is 91 a non-revoked, self-signed DNSKEY with the KSK flag set for each 92 algorithm, and that RRsets other than DNSKEY RRset are signed with 93 a different DNSKEY without the KSK flag set. 94 95 With this flag set, BIND 9 only requires that for each algorithm, there 96 be at least one non-revoked, self-signed DNSKEY, regardless of 97 the KSK flag state, and that other RRsets 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 This option indicates 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