1 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
2 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
3 [<!ENTITY mdash "—">]>
5 - Copyright (C) 2009, 2011 Internet Systems Consortium, Inc. ("ISC")
7 - Permission to use, copy, modify, and/or distribute this software for any
8 - purpose with or without fee is hereby granted, provided that the above
9 - copyright notice and this permission notice appear in all copies.
11 - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
12 - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
13 - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
14 - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
15 - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
16 - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
17 - PERFORMANCE OF THIS SOFTWARE.
20 <!-- $Id: dnssec-revoke.docbook,v 1.7.266.2 2011/10/20 23:46:27 tbox Exp $ -->
21 <refentry id="man.dnssec-revoke">
23 <date>June 1, 2009</date>
27 <refentrytitle><application>dnssec-revoke</application></refentrytitle>
28 <manvolnum>8</manvolnum>
29 <refmiscinfo>BIND9</refmiscinfo>
33 <refname><application>dnssec-revoke</application></refname>
34 <refpurpose>Set the REVOKED bit on a DNSSEC key</refpurpose>
41 <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
47 <command>dnssec-revoke</command>
48 <arg><option>-hr</option></arg>
49 <arg><option>-v <replaceable class="parameter">level</replaceable></option></arg>
50 <arg><option>-K <replaceable class="parameter">directory</replaceable></option></arg>
51 <arg><option>-E <replaceable class="parameter">engine</replaceable></option></arg>
52 <arg><option>-f</option></arg>
53 <arg><option>-R</option></arg>
54 <arg choice="req">keyfile</arg>
59 <title>DESCRIPTION</title>
60 <para><command>dnssec-revoke</command>
61 reads a DNSSEC key file, sets the REVOKED bit on the key as defined
62 in RFC 5011, and creates a new pair of key files containing the
68 <title>OPTIONS</title>
75 Emit usage message and exit.
81 <term>-K <replaceable class="parameter">directory</replaceable></term>
84 Sets the directory in which the key files are to reside.
93 After writing the new keyset files remove the original keyset
100 <term>-v <replaceable class="parameter">level</replaceable></term>
103 Sets the debugging level.
109 <term>-E <replaceable class="parameter">engine</replaceable></term>
112 Use the given OpenSSL engine. When compiled with PKCS#11 support
113 it defaults to pkcs11; the empty name resets it to no engine.
122 Force overwrite: Causes <command>dnssec-revoke</command> to
123 write the new key pair even if a file already exists matching
124 the algorithm and key ID of the revoked key.
133 Print the key tag of the key with the REVOKE bit set but do
142 <title>SEE ALSO</title>
144 <refentrytitle>dnssec-keygen</refentrytitle><manvolnum>8</manvolnum>
146 <citetitle>BIND 9 Administrator Reference Manual</citetitle>,
147 <citetitle>RFC 5011</citetitle>.
152 <title>AUTHOR</title>
153 <para><corpauthor>Internet Systems Consortium</corpauthor>