dnssec-revoke.docbook revision 0c27b3fe77ac1d5094ba3521e8142d9e7973133f
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen<!--
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen - Copyright (C) 2009, 2011, 2014-2016 Internet Systems Consortium, Inc. ("ISC")
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen -
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen - This Source Code Form is subject to the terms of the Mozilla Public
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen - License, v. 2.0. If a copy of the MPL was not distributed with this
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen - file, You can obtain one at http://mozilla.org/MPL/2.0/.
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen-->
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen<!-- Converted by db4-upgrade version 1.0 -->
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="man.dnssec-revoke">
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <info>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <date>2014-01-15</date>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen </info>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <refentryinfo>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <corpname>ISC</corpname>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <corpauthor>Internet Systems Consortium, Inc.</corpauthor>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen </refentryinfo>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <refmeta>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <refentrytitle><application>dnssec-revoke</application></refentrytitle>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <manvolnum>8</manvolnum>
24fe0b3bf671e123467ce1df0b67cadd3614c8e4jmcp <refmiscinfo>BIND9</refmiscinfo>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen </refmeta>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <refnamediv>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <refname><application>dnssec-revoke</application></refname>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <refpurpose>set the REVOKED bit on a DNSSEC key</refpurpose>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen </refnamediv>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <docinfo>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <copyright>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <year>2009</year>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <year>2011</year>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <year>2014</year>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <year>2015</year>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <year>2016</year>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen </copyright>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen </docinfo>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <refsynopsisdiv>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <cmdsynopsis sepchar=" ">
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <command>dnssec-revoke</command>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <arg choice="opt" rep="norepeat"><option>-hr</option></arg>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <arg choice="opt" rep="norepeat"><option>-v <replaceable class="parameter">level</replaceable></option></arg>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <arg choice="opt" rep="norepeat"><option>-V</option></arg>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <arg choice="opt" rep="norepeat"><option>-K <replaceable class="parameter">directory</replaceable></option></arg>
7014882c6a3672fd0e5d60200af8643ae53c5928Richard Lowe <arg choice="opt" rep="norepeat"><option>-E <replaceable class="parameter">engine</replaceable></option></arg>
7014882c6a3672fd0e5d60200af8643ae53c5928Richard Lowe <arg choice="opt" rep="norepeat"><option>-f</option></arg>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <arg choice="opt" rep="norepeat"><option>-R</option></arg>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <arg choice="req" rep="norepeat">keyfile</arg>
a192e900f6d2b0e1a822e3252c0dfd795ed49d76amaguire </cmdsynopsis>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen </refsynopsisdiv>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <refsection><info><title>DESCRIPTION</title></info>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <para><command>dnssec-revoke</command>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen reads a DNSSEC key file, sets the REVOKED bit on the key as defined
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen in RFC 5011, and creates a new pair of key files containing the
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen now-revoked key.
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen </para>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen </refsection>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <refsection><info><title>OPTIONS</title></info>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen
a192e900f6d2b0e1a822e3252c0dfd795ed49d76amaguire <variablelist>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <varlistentry>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <term>-h</term>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <listitem>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <para>
48bc00d6814e04ff3edb32cafe7d1bc580baff68jmcp Emit usage message and exit.
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen </para>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen </listitem>
48bc00d6814e04ff3edb32cafe7d1bc580baff68jmcp </varlistentry>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <varlistentry>
48bc00d6814e04ff3edb32cafe7d1bc580baff68jmcp <term>-K <replaceable class="parameter">directory</replaceable></term>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <listitem>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <para>
48bc00d6814e04ff3edb32cafe7d1bc580baff68jmcp Sets the directory in which the key files are to reside.
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen </para>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen </listitem>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen </varlistentry>
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen
a4ac8bb3f5b2fff60581bee101792ac7a34bad8cdnielsen <varlistentry>
<term>-r</term>
<listitem>
<para>
After writing the new keyset files remove the original keyset
files.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-v <replaceable class="parameter">level</replaceable></term>
<listitem>
<para>
Sets the debugging level.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-V</term>
<listitem>
<para>
Prints version information.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-E <replaceable class="parameter">engine</replaceable></term>
<listitem>
<para>
Specifies the cryptographic hardware to use, when applicable.
</para>
<para>
When BIND is built with OpenSSL PKCS#11 support, this defaults
to the string "pkcs11", which identifies an OpenSSL engine
that can drive a cryptographic accelerator or hardware service
module. When BIND is built with native PKCS#11 cryptography
(--enable-native-pkcs11), it defaults to the path of the PKCS#11
provider library specified via "--with-pkcs11".
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-f</term>
<listitem>
<para>
Force overwrite: Causes <command>dnssec-revoke</command> to
write the new key pair even if a file already exists matching
the algorithm and key ID of the revoked key.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-R</term>
<listitem>
<para>
Print the key tag of the key with the REVOKE bit set but do
not revoke the key.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsection>
<refsection><info><title>SEE ALSO</title></info>
<para><citerefentry>
<refentrytitle>dnssec-keygen</refentrytitle><manvolnum>8</manvolnum>
</citerefentry>,
<citetitle>BIND 9 Administrator Reference Manual</citetitle>,
<citetitle>RFC 5011</citetitle>.
</para>
</refsection>
</refentry>