+# Copyright (C) 2004, 2005, 2007-2009 Internet Systems Consortium, Inc. ("ISC")

+# $Id: Makefile.in,v 1.42 2009-12-05 23:31:40 each Exp $

+CDEFINES = -DVERSION=\"${VERSION}\" @USE_PKCS11@

+ISCNOSYMLIBS = ../../lib/isc/libisc-nosymtbl.@A@

+NOSYMLIBS = ${DNSLIBS} ${ISCNOSYMLIBS} @LIBS@

+

+ dnssec-keyfromlabel@EXEEXT@ dnssec-dsfromkey@EXEEXT@ \

+ dnssec-revoke@EXEEXT@ dnssec-settime@EXEEXT@

+ dnssec-revoke.c dnssec-settime.c dnssec-signzone.c dnssectool.c

+ dnssec-revoke.8 dnssec-settime.8 dnssec-signzone.8

+ dnssec-keygen.html dnssec-revoke.html \

+ dnssec-settime.html dnssec-signzone.html

+ export BASEOBJS="dnssec-dsfromkey.@O@ ${OBJS}"; \

+ ${FINALBUILDCMD}

+ export BASEOBJS="dnssec-keyfromlabel.@O@ ${OBJS}"; \

+ ${FINALBUILDCMD}

+ export BASEOBJS="dnssec-keygen.@O@ ${OBJS}"; \

+ ${FINALBUILDCMD}

+ export BASEOBJS="dnssec-signzone.@O@ ${OBJS}"; \

+ ${FINALBUILDCMD}

+

+dnssec-revoke@EXEEXT@: dnssec-revoke.@O@ ${OBJS} ${DEPLIBS}

+ ${LIBTOOL_MODE_LINK} ${PURIFY} ${CC} ${CFLAGS} ${LDFLAGS} -o $@ \

+ dnssec-revoke.@O@ ${OBJS} ${LIBS}

+

+dnssec-settime@EXEEXT@: dnssec-settime.@O@ ${OBJS} ${DEPLIBS}

+ dnssec-settime.@O@ ${OBJS} ${LIBS}

+.\" Copyright (C) 2008-2010 Internet Systems Consortium, Inc. ("ISC")

+.\" $Id: dnssec-dsfromkey.8,v 1.13 2010-12-24 01:14:20 tbox Exp $

+.\" Date: August 26, 2009

+.TH "DNSSEC\-DSFROMKEY" "8" "August 26, 2009" "BIND9" "BIND9"

+\fBdnssec\-dsfromkey\fR [\fB\-v\ \fR\fB\fIlevel\fR\fR] [\fB\-1\fR] [\fB\-2\fR] [\fB\-a\ \fR\fB\fIalg\fR\fR] [\fB\-l\ \fR\fB\fIdomain\fR\fR] {keyfile}

+\fBdnssec\-dsfromkey\fR {\-s} [\fB\-1\fR] [\fB\-2\fR] [\fB\-a\ \fR\fB\fIalg\fR\fR] [\fB\-K\ \fR\fB\fIdirectory\fR\fR] [\fB\-l\ \fR\fB\fIdomain\fR\fR] [\fB\-s\fR] [\fB\-c\ \fR\fB\fIclass\fR\fR] [\fB\-f\ \fR\fB\fIfile\fR\fR] [\fB\-A\fR] [\fB\-v\ \fR\fB\fIlevel\fR\fR] {dnsname}

+must be one of SHA\-1 (SHA1), SHA\-256 (SHA256) or GOST. These values are case insensitive.

+\-K \fIdirectory\fR

+Look for key files (or, in keyset mode,

+\fIkeyset\-\fR

+files) in

+\fBdirectory\fR.

+.RE

+.PP

+\-f \fIfile\fR

+.RS 4

+Zone file mode: in place of the keyfile name, the argument is the DNS domain name of a zone master file, which can be read from

+\fBfile\fR. If the zone name is the same as

+\fBfile\fR, then it may be omitted.

+.RE

+.PP

+\-A

+.RS 4

+Include ZSK's when generating DS records. Without this option, only keys which have the KSK flag set will be converted to DS records and printed. Useful only in zone file mode.

+.RE

+.PP

+\-l \fIdomain\fR

+.RS 4

+Generate a DLV set instead of a DS set. The specified

+\fBdomain\fR

+is appended to the name for each record in the set. The DNSSEC Lookaside Validation (DLV) RR is described in RFC 4431.

+Keyset mode: in place of the keyfile name, the argument is the DNS domain name of a keyset file.

+Specifies the DNS class (default is IN). Useful only in keyset or zone file mode.

+\-v \fIlevel\fR

+Sets the debugging level.

+RFC 4431.

+Copyright \(co 2008\-2010 Internet Systems Consortium, Inc. ("ISC")

+/* $Id: dnssec-dsfromkey.c,v 1.19 2010-12-23 04:07:59 marka Exp $ */

+#include <dns/keyvalues.h>

+#include <dns/master.h>

+#ifndef PATH_MAX

+#define PATH_MAX 1024 /* AIX, WIN32, and others don't define this. */

+#endif

+

+static dns_fixedname_t fixed;

+static dns_name_t *name = NULL;

+static isc_mem_t *mctx = NULL;

+static isc_result_t

+initname(char *setname) {

+ isc_result_t result;

+ isc_buffer_t buf;

+ result = dns_name_fromtext(name, &buf, dns_rootname, 0, NULL);

+ return (result);

+}

+static isc_result_t

+loadsetfromfile(char *filename, dns_rdataset_t *rdataset) {

+ isc_result_t result;

+ dns_db_t *db = NULL;

+ dns_dbnode_t *node = NULL;

+ char setname[DNS_NAME_FORMATSIZE];

+ dns_name_format(name, setname, sizeof(setname));

+ 0, 0, rdataset, NULL);

+

+

+ if (node != NULL)

+ dns_db_detachnode(db, &node);

+ if (db != NULL)

+ dns_db_detach(&db);

+ return (result);

+}

+

+static isc_result_t

+loadkeyset(char *dirname, dns_rdataset_t *rdataset) {

+ isc_result_t result;

+ char filename[PATH_MAX + 1];

+ isc_buffer_t buf;

+

+ dns_rdataset_init(rdataset);

+

+ isc_buffer_init(&buf, filename, sizeof(filename));

+ if (dirname != NULL) {

+ /* allow room for a trailing slash */

+ if (strlen(dirname) >= isc_buffer_availablelength(&buf))

+ return (ISC_R_NOSPACE);

+ isc_buffer_putstr(&buf, dirname);

+ if (dirname[strlen(dirname) - 1] != '/')

+ isc_buffer_putstr(&buf, "/");

+ }

+

+ if (isc_buffer_availablelength(&buf) < 7)

+ return (ISC_R_NOSPACE);

+ isc_buffer_putstr(&buf, "keyset-");

+

+ result = dns_name_tofilenametext(name, ISC_FALSE, &buf);

+ check_result(result, "dns_name_tofilenametext()");

+ if (isc_buffer_availablelength(&buf) == 0)

+ return (ISC_R_NOSPACE);

+ isc_buffer_putuint8(&buf, 0);

+

+ return (loadsetfromfile(filename, rdataset));

+ result = dst_key_fromnamedfile(filename, NULL, DST_TYPE_PUBLIC,

+ mctx, &key);

+ char keystr[DST_KEY_FORMATSIZE];

+ dst_key_format(key, keystr, sizeof(keystr));

+ char keystr[DST_KEY_FORMATSIZE];

+ dst_key_format(key, keystr, sizeof(keystr));

+emit(unsigned int dtype, isc_boolean_t showall, char *lookaside,

+ dns_rdata_t *rdata)

+ isc_result_t result;

+ unsigned char buf[DNS_DS_BUFFERSIZE];

+ char text_buf[DST_KEY_MAXTEXTSIZE];

+ char name_buf[DNS_NAME_MAXWIRE];

+ char class_buf[10];

+ isc_buffer_t textb, nameb, classb;

+ isc_region_t r;

+ dns_rdata_t ds;

+ dns_rdata_dnskey_t dnskey;

+ isc_buffer_init(&nameb, name_buf, sizeof(name_buf));

+ result = dns_rdata_tostruct(rdata, &dnskey, NULL);

+ if (result != ISC_R_SUCCESS)

+ fatal("can't convert DNSKEY");

+

+ if ((dnskey.flags & DNS_KEYFLAG_KSK) == 0 && !showall)

+ return;

+

+ fatal("can't build record");

+

+ result = dns_name_totext(name, ISC_FALSE, &nameb);

+ if (result != ISC_R_SUCCESS)

+ fatal("can't print name");

+

+ /* Add lookaside origin, if set */

+ if (lookaside != NULL) {

+ if (isc_buffer_availablelength(&nameb) < strlen(lookaside))

+ fatal("DLV origin '%s' is too long", lookaside);

+ isc_buffer_putstr(&nameb, lookaside);

+ if (lookaside[strlen(lookaside) - 1] != '.') {

+ if (isc_buffer_availablelength(&nameb) < 1)

+ fatal("DLV origin '%s' is too long", lookaside);

+ isc_buffer_putstr(&nameb, ".");

+ }

+ }

+ fatal("can't print rdata");

+ fatal("can't print class");

+ isc_buffer_usedregion(&nameb, &r);

+ isc_util_fwrite(r.base, 1, r.length, stdout);

+ if (lookaside == NULL)

+ printf(" DS ");

+ else

+ printf(" DLV ");

+ISC_PLATFORM_NORETURN_PRE static void

+usage(void) ISC_PLATFORM_NORETURN_POST;

+

+ fprintf(stderr, " %s options [-K dir] keyfile\n\n", program);

+ fprintf(stderr, " %s options [-K dir] [-c class] -s dnsname\n\n",

+ fprintf(stderr, " %s options -f zonefile (as zone name)\n\n", program);

+ fprintf(stderr, " %s options -f zonefile zonename\n\n", program);

+ fprintf(stderr, " -K <directory>: directory in which to find "

+ "key file or keyset file\n");

+ fprintf(stderr, " -a algorithm: digest algorithm "

+ "(SHA-1, SHA-256 or GOST)\n");

+ fprintf(stderr, " -l: add lookaside zone and print DLV records\n");

+ fprintf(stderr, " -s: read keyset from keyset-<dnsname> file\n");

+ fprintf(stderr, " -c class: rdata class for DS set (default: IN)\n");

+ fprintf(stderr, " -f file: read keyset from zone file\n");

+ fprintf(stderr, " -A: when used with -f, "

+ "include all keys in DS set, not just KSKs\n");

+ fprintf(stderr, "Output: DS or DLV RRs\n");

+ char *algname = NULL, *classname = NULL;

+ char *filename = NULL, *dir = NULL, *namestr;

+ char *lookaside = NULL;

+ char *endp;

+ int ch;

+ unsigned int dtype = DNS_DSDIGEST_SHA1;

+ isc_boolean_t both = ISC_TRUE;

+ isc_boolean_t usekeyset = ISC_FALSE;

+ isc_boolean_t showall = ISC_FALSE;

+ isc_result_t result;

+ isc_log_t *log = NULL;

+ isc_entropy_t *ectx = NULL;

+ dns_rdataset_t rdataset;

+ dns_rdata_t rdata;

+ "12Aa:c:d:Ff:K:l:sv:h")) != -1) {

+ case 'A':

+ showall = ISC_TRUE;

+ break;

+ fprintf(stderr, "%s: the -d option is deprecated; "

+ "use -K\n", program);

+ /* fall through */

+ case 'K':

+ dir = isc_commandline_argument;

+ if (strlen(dir) == 0U)

+ fatal("directory must be non-empty string");

+ break;

+ case 'f':

+ filename = isc_commandline_argument;

+ break;

+ case 'l':

+ lookaside = isc_commandline_argument;

+ if (strlen(lookaside) == 0U)

+ fatal("lookaside must be a non-empty string");

+ case 'F':

+ /* Reserved for FIPS mode */

+ /* FALLTHROUGH */

+ /* FALLTHROUGH */

+#ifdef HAVE_OPENSSL_GOST

+ else if (strcasecmp(algname, "GOST") == 0)

+ dtype = DNS_DSDIGEST_GOST;

+#endif

+ if (usekeyset && filename != NULL)

+ fatal("cannot use both -s and -f");

+

+ /* When not using -f, -A is implicit */

+ if (filename == NULL)

+ showall = ISC_TRUE;

+

+ if (argc < isc_commandline_index + 1 && filename == NULL)

+ fatal("could not initialize dst: %s",

+ isc_result_totext(result));

+ dns_rdataset_init(&rdataset);

+

+ if (usekeyset || filename != NULL) {

+ if (argc < isc_commandline_index + 1 && filename != NULL) {

+ /* using zone name as the zone file name */

+ namestr = filename;

+ } else

+ namestr = argv[isc_commandline_index];

+ result = initname(namestr);

+ if (result != ISC_R_SUCCESS)

+ fatal("could not initialize name %s", namestr);

+

+ if (usekeyset)

+ result = loadkeyset(dir, &rdataset);

+ else

+ result = loadsetfromfile(filename, &rdataset);

+

+ if (result != ISC_R_SUCCESS)

+ fatal("could not load DNSKEY set: %s\n",

+ isc_result_totext(result));

+

+ for (result = dns_rdataset_first(&rdataset);

+ result = dns_rdataset_next(&rdataset)) {

+ dns_rdataset_current(&rdataset, &rdata);

+ emit(DNS_DSDIGEST_SHA1, showall, lookaside,

+ &rdata);

+ emit(DNS_DSDIGEST_SHA256, showall, lookaside,

+ &rdata);

+ emit(dtype, showall, lookaside, &rdata);

+ emit(DNS_DSDIGEST_SHA1, showall, lookaside, &rdata);

+ emit(DNS_DSDIGEST_SHA256, showall, lookaside, &rdata);

+ emit(dtype, showall, lookaside, &rdata);

+ if (dns_rdataset_isassociated(&rdataset))

+ dns_rdataset_disassociate(&rdataset);

+ - Copyright (C) 2008-2010 Internet Systems Consortium, Inc. ("ISC")

+<!-- $Id: dnssec-dsfromkey.docbook,v 1.12 2010-12-23 23:47:08 tbox Exp $ -->

+ <date>August 26, 2009</date>

+ <year>2009</year>

+ <year>2010</year>

+ <arg><option>-l <replaceable class="parameter">domain</replaceable></option></arg>

+ <arg><option>-K <replaceable class="parameter">directory</replaceable></option></arg>

+ <arg><option>-l <replaceable class="parameter">domain</replaceable></option></arg>

+ <arg><option>-s</option></arg>

+ <arg><option>-f <replaceable class="parameter">file</replaceable></option></arg>

+ <arg><option>-A</option></arg>

+ <arg><option>-v <replaceable class="parameter">level</replaceable></option></arg>

+ <option>algorithm</option> must be one of SHA-1 (SHA1),

+ SHA-256 (SHA256) or GOST. These values are case insensitive.

+ <term>-K <replaceable class="parameter">directory</replaceable></term>

+ Look for key files (or, in keyset mode,

+ <filename>keyset-</filename> files) in

+ <option>directory</option>.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-f <replaceable class="parameter">file</replaceable></term>

+ <listitem>

+ <para>

+ Zone file mode: in place of the keyfile name, the argument is

+ the DNS domain name of a zone master file, which can be read

+ from <option>file</option>. If the zone name is the same as

+ <option>file</option>, then it may be omitted.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-A</term>

+ <listitem>

+ <para>

+ Include ZSK's when generating DS records. Without this option,

+ only keys which have the KSK flag set will be converted to DS

+ records and printed. Useful only in zone file mode.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-l <replaceable class="parameter">domain</replaceable></term>

+ <listitem>

+ <para>

+ Generate a DLV set instead of a DS set. The specified

+ <option>domain</option> is appended to the name for each

+ record in the set.

+ The DNSSEC Lookaside Validation (DLV) RR is described

+ in RFC 4431.

+ the DNS domain name of a keyset file.

+ Specifies the DNS class (default is IN). Useful only

+ in keyset or zone file mode.

+ <term>-v <replaceable class="parameter">level</replaceable></term>

+ Sets the debugging level.

+ <citetitle>RFC 4431</citetitle>.

+ - Copyright (C) 2008-2010 Internet Systems Consortium, Inc. ("ISC")

+<!-- $Id: dnssec-dsfromkey.html,v 1.13 2010-12-24 01:14:19 tbox Exp $ -->

+<div class="cmdsynopsis"><p><code class="command">dnssec-dsfromkey</code> [<code class="option">-v <em class="replaceable"><code>level</code></em></code>] [<code class="option">-1</code>] [<code class="option">-2</code>] [<code class="option">-a <em class="replaceable"><code>alg</code></em></code>] [<code class="option">-l <em class="replaceable"><code>domain</code></em></code>] {keyfile}</p></div>

+<div class="cmdsynopsis"><p><code class="command">dnssec-dsfromkey</code> {-s} [<code class="option">-1</code>] [<code class="option">-2</code>] [<code class="option">-a <em class="replaceable"><code>alg</code></em></code>] [<code class="option">-K <em class="replaceable"><code>directory</code></em></code>] [<code class="option">-l <em class="replaceable"><code>domain</code></em></code>] [<code class="option">-s</code>] [<code class="option">-c <em class="replaceable"><code>class</code></em></code>] [<code class="option">-f <em class="replaceable"><code>file</code></em></code>] [<code class="option">-A</code>] [<code class="option">-v <em class="replaceable"><code>level</code></em></code>] {dnsname}</p></div>

+<a name="id2543464"></a><h2>DESCRIPTION</h2>

+<a name="id2543476"></a><h2>OPTIONS</h2>

+ <code class="option">algorithm</code> must be one of SHA-1 (SHA1),

+ SHA-256 (SHA256) or GOST. These values are case insensitive.

+<dt><span class="term">-K <em class="replaceable"><code>directory</code></em></span></dt>

+ Look for key files (or, in keyset mode,

+ <code class="filename">keyset-</code> files) in

+ <code class="option">directory</code>.

+ </p></dd>

+<dt><span class="term">-f <em class="replaceable"><code>file</code></em></span></dt>

+<dd><p>

+ Zone file mode: in place of the keyfile name, the argument is

+ the DNS domain name of a zone master file, which can be read

+ from <code class="option">file</code>. If the zone name is the same as

+ <code class="option">file</code>, then it may be omitted.

+ </p></dd>

+<dt><span class="term">-A</span></dt>

+<dd><p>

+ Include ZSK's when generating DS records. Without this option,

+ only keys which have the KSK flag set will be converted to DS

+ records and printed. Useful only in zone file mode.

+ </p></dd>

+<dt><span class="term">-l <em class="replaceable"><code>domain</code></em></span></dt>

+<dd><p>

+ Generate a DLV set instead of a DS set. The specified

+ <code class="option">domain</code> is appended to the name for each

+ record in the set.

+ The DNSSEC Lookaside Validation (DLV) RR is described

+ in RFC 4431.

+ the DNS domain name of a keyset file.

+ Specifies the DNS class (default is IN). Useful only

+ in keyset or zone file mode.

+<dt><span class="term">-v <em class="replaceable"><code>level</code></em></span></dt>

+ Sets the debugging level.

+<a name="id2543662"></a><h2>EXAMPLE</h2>

+<a name="id2543692"></a><h2>FILES</h2>

+<a name="id2543728"></a><h2>CAVEAT</h2>

+<a name="id2543737"></a><h2>SEE ALSO</h2>

+ <em class="citetitle">RFC 4431</em>.

+<a name="id2543777"></a><h2>AUTHOR</h2>

+.\" Copyright (C) 2008-2011 Internet Systems Consortium, Inc. ("ISC")

+.\" $Id: dnssec-keyfromlabel.8,v 1.18.14.1.2.1 2011-06-09 03:41:05 tbox Exp $

+\fBdnssec\-keyfromlabel\fR {\-l\ \fIlabel\fR} [\fB\-3\fR] [\fB\-a\ \fR\fB\fIalgorithm\fR\fR] [\fB\-A\ \fR\fB\fIdate/offset\fR\fR] [\fB\-c\ \fR\fB\fIclass\fR\fR] [\fB\-D\ \fR\fB\fIdate/offset\fR\fR] [\fB\-E\ \fR\fB\fIengine\fR\fR] [\fB\-f\ \fR\fB\fIflag\fR\fR] [\fB\-G\fR] [\fB\-I\ \fR\fB\fIdate/offset\fR\fR] [\fB\-k\fR] [\fB\-K\ \fR\fB\fIdirectory\fR\fR] [\fB\-n\ \fR\fB\fInametype\fR\fR] [\fB\-P\ \fR\fB\fIdate/offset\fR\fR] [\fB\-p\ \fR\fB\fIprotocol\fR\fR] [\fB\-R\ \fR\fB\fIdate/offset\fR\fR] [\fB\-t\ \fR\fB\fItype\fR\fR] [\fB\-v\ \fR\fB\fIlevel\fR\fR] [\fB\-y\fR] {name}

+.PP

+The

+\fBname\fR

+of the key is specified on the command line. This must match the name of the zone for which the key is being generated.

+must be one of RSAMD5, RSASHA1, DSA, NSEC3RSASHA1, NSEC3DSA, RSASHA256, RSASHA512 or ECCGOST. These values are case insensitive.

+\-3

+.RS 4

+Use an NSEC3\-capable algorithm to generate a DNSSEC key. If this option is used and no algorithm is explicitly set on the command line, NSEC3RSASHA1 will be used by default.

+.RE

+.PP

+\-E \fIengine\fR

+.RS 4

+Specifies the name of the crypto hardware (OpenSSL engine). When compiled with PKCS#11 support it defaults to "pkcs11".

+.RE

+.PP

+Specifies the label of the key pair in the crypto hardware. The label may be preceded by an optional OpenSSL engine name, separated by a colon, as in "pkcs11:keylabel".

+\-C

+.RS 4

+Compatibility mode: generates an old\-style key, without any metadata. By default,

+\fBdnssec\-keyfromlabel\fR

+will include the key's creation date in the metadata stored with the private key, and other dates may be set there as well (publication date, activation date, etc). Keys that include this data may be incompatible with older versions of BIND; the

+\fB\-C\fR

+option suppresses them.

+.RE

+.PP

+Set the specified flag in the flag field of the KEY/DNSKEY record. The only recognized flags are KSK (Key Signing Key) and REVOKE.

+.RE

+.PP

+\-G

+.RS 4

+Generate a key, but do not publish it or sign with it. This option is incompatible with \-P and \-A.

+\fBdnssec\-keyfromlabel\fR.

+.RE

+.PP

+\-K \fIdirectory\fR

+.RS 4

+Sets the directory in which the key files are to be written.

+Sets the protocol value for the key. The protocol is a number between 0 and 255. The default is 3 (DNSSEC). Other possible values for this argument are listed in RFC 2535 and its successors.

+.PP

+\-y

+.RS 4

+Allows DNSSEC key files to be generated even if the key ID would collide with that of an existing key, in the event of either key being revoked. (This is only safe to use if you are sure you won't be using RFC 5011 trust anchor maintenance with either of the keys involved.)

+.RE

+.SH "TIMING OPTIONS"

+.PP

+Dates can be expressed in the format YYYYMMDD or YYYYMMDDHHMMSS. If the argument begins with a '+' or '\-', it is interpreted as an offset from the present time. For convenience, if such an offset is followed by one of the suffixes 'y', 'mo', 'w', 'd', 'h', or 'mi', then the offset is computed in years (defined as 365 24\-hour days, ignoring leap years), months (defined as 30 24\-hour days), weeks, days, hours, or minutes, respectively. Without a suffix, the offset is computed in seconds.

+.PP

+\-P \fIdate/offset\fR

+.RS 4

+Sets the date on which a key is to be published to the zone. After that date, the key will be included in the zone but will not be used to sign it. If not set, and if the \-G option has not been used, the default is "now".

+.RE

+.PP

+\-A \fIdate/offset\fR

+.RS 4

+Sets the date on which the key is to be activated. After that date, the key will be included in the zone and used to sign it. If not set, and if the \-G option has not been used, the default is "now".

+.RE

+.PP

+\-R \fIdate/offset\fR

+.RS 4

+Sets the date on which the key is to be revoked. After that date, the key will be flagged as revoked. It will be included in the zone and will be used to sign it.

+.RE

+.PP

+\-I \fIdate/offset\fR

+.RS 4

+Sets the date on which the key is to be retired. After that date, the key will still be included in the zone, but it will not be used to sign it.

+.RE

+.PP

+\-D \fIdate/offset\fR

+.RS 4

+Sets the date on which the key is to be deleted. After that date, the key will no longer be included in the zone. (It may remain in the key repository, however.)

+.RE

+file contains algorithm\-specific fields. For obvious security reasons, this file does not have general read permission.

+Copyright \(co 2008\-2011 Internet Systems Consortium, Inc. ("ISC")

+ * Copyright (C) 2007-2010 Internet Systems Consortium, Inc. ("ISC")

+/* $Id: dnssec-keyfromlabel.c,v 1.32 2010-12-23 04:07:59 marka Exp $ */

+#include <ctype.h>

+#include <isc/print.h>

+#include <dns/dnssec.h>

+#define DEFAULT_ALGORITHM "RSASHA1"

+#define DEFAULT_NSEC3_ALGORITHM "NSEC3RSASHA1"

+

+ " RSASHA256 | RSASHA512 | ECCGOST";

+

+ISC_PLATFORM_NORETURN_PRE static void

+usage(void) ISC_PLATFORM_NORETURN_POST;

+ fprintf(stderr, " %s -l label [options] name\n\n",

+ fprintf(stderr, " -l label: label of the key pair\n");

+ fprintf(stderr, " -a algorithm: %s\n", algs);

+ fprintf(stderr, " (default: RSASHA1, or "

+ "NSEC3RSASHA1 if using -3)\n");

+ fprintf(stderr, " -3: use NSEC3-capable algorithm\n");

+ fprintf(stderr, " -c class (default: IN)\n");

+#ifdef USE_PKCS11

+ fprintf(stderr, " -E enginename (default: pkcs11)\n");

+#else

+ fprintf(stderr, " -E enginename\n");

+#endif

+ fprintf(stderr, " -f keyflag: KSK | REVOKE\n");

+ fprintf(stderr, " -K directory: directory in which to place "

+ "key files\n");

+ fprintf(stderr, " -k: generate a TYPE=KEY key\n");

+ fprintf(stderr, " -p protocol: default: 3 [dnssec]\n");

+ fprintf(stderr, " -t type: "

+ fprintf(stderr, " -y: permit keys that might collide\n");

+ fprintf(stderr, " -v verbose level\n");

+ fprintf(stderr, "Date options:\n");

+ fprintf(stderr, " -P date/[+-]offset: set key publication date\n");

+ fprintf(stderr, " -A date/[+-]offset: set key activation date\n");

+ fprintf(stderr, " -R date/[+-]offset: set key revocation date\n");

+ fprintf(stderr, " -I date/[+-]offset: set key inactivation date\n");

+ fprintf(stderr, " -D date/[+-]offset: set key deletion date\n");

+ fprintf(stderr, " -G: generate key only; do not set -P or -A\n");

+ fprintf(stderr, " -C: generate a backward-compatible key, omitting"

+ " all dates\n");

+ "K<name>+<alg>+<id>.private\n");

+ const char *directory = NULL;

+#ifdef USE_PKCS11

+ const char *engine = "pkcs11";

+#else

+ const char *engine = NULL;

+#endif

+ dst_key_t *key = NULL;

+ isc_uint16_t flags = 0, kskflag = 0, revflag = 0;

+ isc_boolean_t oldstyle = ISC_FALSE;

+ isc_stdtime_t publish = 0, activate = 0, revoke = 0;

+ isc_stdtime_t inactive = 0, delete = 0;

+ isc_stdtime_t now;

+ isc_boolean_t setpub = ISC_FALSE, setact = ISC_FALSE;

+ isc_boolean_t setrev = ISC_FALSE, setinact = ISC_FALSE;

+ isc_boolean_t setdel = ISC_FALSE;

+ isc_boolean_t unsetpub = ISC_FALSE, unsetact = ISC_FALSE;

+ isc_boolean_t unsetrev = ISC_FALSE, unsetinact = ISC_FALSE;

+ isc_boolean_t unsetdel = ISC_FALSE;

+ isc_boolean_t genonly = ISC_FALSE;

+ isc_boolean_t use_nsec3 = ISC_FALSE;

+ isc_boolean_t avoid_collisions = ISC_TRUE;

+ isc_boolean_t exact;

+ unsigned char c;

+ isc_stdtime_get(&now);

+

+ "3a:Cc:E:f:K:kl:n:p:t:v:yFhGP:A:R:I:D:")) != -1)

+ case '3':

+ use_nsec3 = ISC_TRUE;

+ break;

+ case 'C':

+ oldstyle = ISC_TRUE;

+ break;

+ case 'E':

+ engine = isc_commandline_argument;

+ break;

+ c = (unsigned char)(isc_commandline_argument[0]);

+ if (toupper(c) == 'K')

+ kskflag = DNS_KEYFLAG_KSK;

+ else if (toupper(c) == 'R')

+ revflag = DNS_KEYFLAG_REVOKE;

+ case 'K':

+ directory = isc_commandline_argument;

+ ret = try_dir(directory);

+ if (ret != ISC_R_SUCCESS)

+ fatal("cannot open directory %s: %s",

+ directory, isc_result_totext(ret));

+ break;

+ label = isc_mem_strdup(mctx, isc_commandline_argument);

+ case 'y':

+ avoid_collisions = ISC_FALSE;

+ break;

+ case 'G':

+ genonly = ISC_TRUE;

+ break;

+ case 'P':

+ if (setpub || unsetpub)

+ fatal("-P specified more than once");

+

+ if (strcasecmp(isc_commandline_argument, "none")) {

+ setpub = ISC_TRUE;

+ publish = strtotime(isc_commandline_argument,

+ now, now);

+ } else {

+ unsetpub = ISC_TRUE;

+ }

+ break;

+ case 'A':

+ if (setact || unsetact)

+ fatal("-A specified more than once");

+

+ if (strcasecmp(isc_commandline_argument, "none")) {

+ setact = ISC_TRUE;

+ activate = strtotime(isc_commandline_argument,

+ now, now);

+ } else {

+ unsetact = ISC_TRUE;

+ }

+ break;

+ case 'R':

+ if (setrev || unsetrev)

+ fatal("-R specified more than once");

+

+ if (strcasecmp(isc_commandline_argument, "none")) {

+ setrev = ISC_TRUE;

+ revoke = strtotime(isc_commandline_argument,

+ now, now);

+ } else {

+ unsetrev = ISC_TRUE;

+ }

+ break;

+ case 'I':

+ if (setinact || unsetinact)

+ fatal("-I specified more than once");

+

+ if (strcasecmp(isc_commandline_argument, "none")) {

+ setinact = ISC_TRUE;

+ inactive = strtotime(isc_commandline_argument,

+ now, now);

+ } else {

+ unsetinact = ISC_TRUE;

+ }

+ break;

+ case 'D':

+ if (setdel || unsetdel)

+ fatal("-D specified more than once");

+

+ if (strcasecmp(isc_commandline_argument, "none")) {

+ setdel = ISC_TRUE;

+ delete = strtotime(isc_commandline_argument,

+ now, now);

+ } else {

+ unsetdel = ISC_TRUE;

+ }

+ break;

+ case 'F':

+ /* Reserved for FIPS mode */

+ /* FALLTHROUGH */

+ /* FALLTHROUGH */

+ ret = dst_lib_init2(mctx, ectx, engine,

+ ISC_ENTROPY_BLOCKING | ISC_ENTROPY_GOODONLY);

+ fatal("could not initialize dst: %s",

+ isc_result_totext(ret));

+ if (strchr(label, ':') == NULL &&

+ engine != NULL && strlen(engine) != 0U) {

+ char *l;

+ int len;

+

+ len = strlen(label) + strlen(engine) + 2;

+ l = isc_mem_allocate(mctx, len);

+ if (l == NULL)

+ fatal("cannot allocate memory");

+ snprintf(l, len, "%s:%s", engine, label);

+ isc_mem_free(mctx, label);

+ label = l;

+ }

+

+ if (algname == NULL) {

+ if (use_nsec3)

+ algname = strdup(DEFAULT_NSEC3_ALGORITHM);

+ else

+ algname = strdup(DEFAULT_ALGORITHM);

+ if (verbose > 0)

+ fprintf(stderr, "no algorithm specified; "

+ "defaulting to %s\n", algname);

+ }

+

+ if (use_nsec3 &&

+ alg != DST_ALG_NSEC3DSA && alg != DST_ALG_NSEC3RSASHA1 &&

+ alg != DST_ALG_RSASHA256 && alg != DST_ALG_RSASHA512 &&

+ alg != DST_ALG_ECCGOST) {

+ fatal("%s is incompatible with NSEC3; "

+ "do not use the -3 option", algname);

+ }

+

+ if (directory == NULL)

+ directory = ".";

+

+ else if ((flags & DNS_KEYOWNER_ZONE) != 0) { /* DNSKEY */

+ flags |= kskflag;

+ flags |= revflag;

+ }

+ ret = dns_name_fromtext(name, &buf, dns_rootname, 0, NULL);

+ rdclass, engine, label, NULL, mctx, &key);

+ char algstr[DNS_SECALG_FORMATSIZE];

+ dns_secalg_format(alg, algstr, sizeof(algstr));

+ fatal("failed to get key %s/%s: %s\n",

+ /* NOTREACHED */

+ * Set key timing metadata (unless using -C)

+ *

+ * Publish and activation dates are set to "now" by default, but

+ * can be overridden. Creation date is always set to "now".

+ if (!oldstyle) {

+ dst_key_settime(key, DST_TIME_CREATED, now);

+

+ if (genonly && (setpub || setact))

+ fatal("cannot use -G together with -P or -A options");

+

+ if (setpub)

+ dst_key_settime(key, DST_TIME_PUBLISH, publish);

+ else if (setact)

+ dst_key_settime(key, DST_TIME_PUBLISH, activate);

+ else if (!genonly && !unsetpub)

+ dst_key_settime(key, DST_TIME_PUBLISH, now);

+

+ if (setact)

+ dst_key_settime(key, DST_TIME_ACTIVATE, activate);

+ else if (!genonly && !unsetact)

+ dst_key_settime(key, DST_TIME_ACTIVATE, now);

+

+ if (setrev) {

+ if (kskflag == 0)

+ fprintf(stderr, "%s: warning: Key is "

+ "not flagged as a KSK, but -R "

+ "was used. Revoking a ZSK is "

+ "legal, but undefined.\n",

+ program);

+ dst_key_settime(key, DST_TIME_REVOKE, revoke);

+ }

+

+ if (setinact)

+ dst_key_settime(key, DST_TIME_INACTIVE, inactive);

+

+ if (setdel)

+ dst_key_settime(key, DST_TIME_DELETE, delete);

+ } else {

+ if (setpub || setact || setrev || setinact ||

+ setdel || unsetpub || unsetact ||

+ unsetrev || unsetinact || unsetdel || genonly)

+ fatal("cannot use -C together with "

+ "-P, -A, -R, -I, -D, or -G options");

+ /*

+ * Compatibility mode: Private-key-format

+ * should be set to 1.2.

+ */

+ dst_key_setprivateformat(key, 1, 2);

+ }

+

+ /*

+ * Do not overwrite an existing key. Warn LOUDLY if there

+ * is a risk of ID collision due to this key or another key

+ * being revoked.

+ */

+ if (key_collision(dst_key_id(key), name, directory, alg, mctx, &exact))

+ {

+ ret = dst_key_buildfilename(key, 0, directory, &buf);

+ if (exact)

+ fatal("%s: %s already exists\n", program, filename);

+

+ if (avoid_collisions)

+ fatal("%s: %s could collide with another key upon "

+ "revokation\n", program, filename);

+

+ fprintf(stderr, "%s: WARNING: Key %s could collide with "

+ "another key upon revokation. If you plan "

+ "to revoke keys, destroy this key and "

+ "generate a different one.\n",

+ program, filename);

+ ret = dst_key_tofile(key, options, directory);

+ char keystr[DST_KEY_FORMATSIZE];

+ dst_key_format(key, keystr, sizeof(keystr));

+ isc_mem_free(mctx, label);

+ - Copyright (C) 2008-2011 Internet Systems Consortium, Inc. ("ISC")

+<!-- $Id: dnssec-keyfromlabel.docbook,v 1.18.14.1.2.1 2011-06-02 23:47:27 tbox Exp $ -->

+ <year>2009</year>

+ <year>2011</year>

+ <arg><option>-3</option></arg>

+ <arg><option>-a <replaceable class="parameter">algorithm</replaceable></option></arg>

+ <arg><option>-A <replaceable class="parameter">date/offset</replaceable></option></arg>

+ <arg><option>-D <replaceable class="parameter">date/offset</replaceable></option></arg>

+ <arg><option>-E <replaceable class="parameter">engine</replaceable></option></arg>

+ <arg><option>-G</option></arg>

+ <arg><option>-I <replaceable class="parameter">date/offset</replaceable></option></arg>

+ <arg><option>-K <replaceable class="parameter">directory</replaceable></option></arg>

+ <arg><option>-P <replaceable class="parameter">date/offset</replaceable></option></arg>

+ <arg><option>-R <replaceable class="parameter">date/offset</replaceable></option></arg>

+ <arg><option>-y</option></arg>

+ <para>

+ The <option>name</option> of the key is specified on the command

+ line. This must match the name of the zone for which the key is

+ being generated.

+ </para>

+ <option>algorithm</option> must be one of RSAMD5, RSASHA1,

+ DSA, NSEC3RSASHA1, NSEC3DSA, RSASHA256, RSASHA512 or ECCGOST.

+ <term>-3</term>

+ <listitem>

+ <para>

+ Use an NSEC3-capable algorithm to generate a DNSSEC key.

+ If this option is used and no algorithm is explicitly

+ set on the command line, NSEC3RSASHA1 will be used by

+ default.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-E <replaceable class="parameter">engine</replaceable></term>

+ <listitem>

+ <para>

+ Specifies the name of the crypto hardware (OpenSSL engine).

+ When compiled with PKCS#11 support it defaults to "pkcs11".

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ Specifies the label of the key pair in the crypto hardware.

+ The label may be preceded by an optional OpenSSL engine name,

+ separated by a colon, as in "pkcs11:keylabel".

+ These values are case insensitive.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-C</term>

+ <listitem>

+ <para>

+ Compatibility mode: generates an old-style key, without

+ any metadata. By default, <command>dnssec-keyfromlabel</command>

+ will include the key's creation date in the metadata stored

+ with the private key, and other dates may be set there as well

+ (publication date, activation date, etc). Keys that include

+ this data may be incompatible with older versions of BIND; the

+ <option>-C</option> option suppresses them.

+ The only recognized flags are KSK (Key Signing Key) and REVOKE.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-G</term>

+ <listitem>

+ <para>

+ Generate a key, but do not publish it or sign with it. This

+ option is incompatible with -P and -A.

+ <command>dnssec-keyfromlabel</command>.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-K <replaceable class="parameter">directory</replaceable></term>

+ <listitem>

+ <para>

+ Sets the directory in which the key files are to be written.

+ Sets the protocol value for the key. The protocol

+ <varlistentry>

+ <term>-y</term>

+ <listitem>

+ <para>

+ Allows DNSSEC key files to be generated even if the key ID

+ would collide with that of an existing key, in the event of

+ either key being revoked. (This is only safe to use if you

+ are sure you won't be using RFC 5011 trust anchor maintenance

+ with either of the keys involved.)

+ </para>

+ </listitem>

+ </varlistentry>

+

+ </variablelist>

+ </refsect1>

+

+ <refsect1>

+ <title>TIMING OPTIONS</title>

+

+ <para>

+ Dates can be expressed in the format YYYYMMDD or YYYYMMDDHHMMSS.

+ If the argument begins with a '+' or '-', it is interpreted as

+ an offset from the present time. For convenience, if such an offset

+ is followed by one of the suffixes 'y', 'mo', 'w', 'd', 'h', or 'mi',

+ then the offset is computed in years (defined as 365 24-hour days,

+ ignoring leap years), months (defined as 30 24-hour days), weeks,

+ days, hours, or minutes, respectively. Without a suffix, the offset

+ is computed in seconds.

+ </para>

+

+ <variablelist>

+ <varlistentry>

+ <term>-P <replaceable class="parameter">date/offset</replaceable></term>

+ <listitem>

+ <para>

+ Sets the date on which a key is to be published to the zone.

+ After that date, the key will be included in the zone but will

+ not be used to sign it. If not set, and if the -G option has

+ not been used, the default is "now".

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-A <replaceable class="parameter">date/offset</replaceable></term>

+ <listitem>

+ <para>

+ Sets the date on which the key is to be activated. After that

+ date, the key will be included in the zone and used to sign

+ it. If not set, and if the -G option has not been used, the

+ default is "now".

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-R <replaceable class="parameter">date/offset</replaceable></term>

+ <listitem>

+ <para>

+ Sets the date on which the key is to be revoked. After that

+ date, the key will be flagged as revoked. It will be included

+ in the zone and will be used to sign it.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-I <replaceable class="parameter">date/offset</replaceable></term>

+ <listitem>

+ <para>

+ Sets the date on which the key is to be retired. After that

+ date, the key will still be included in the zone, but it

+ will not be used to sign it.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-D <replaceable class="parameter">date/offset</replaceable></term>

+ <listitem>

+ <para>

+ Sets the date on which the key is to be deleted. After that

+ date, the key will no longer be included in the zone. (It

+ may remain in the key repository, however.)

+ </para>

+ </listitem>

+ </varlistentry>

+ of the algorithm.

+ private key.

+ The <filename>.private</filename> file contains

+ algorithm-specific

+ - Copyright (C) 2008-2011 Internet Systems Consortium, Inc. ("ISC")

+<!-- $Id: dnssec-keyfromlabel.html,v 1.17.14.1.2.1 2011-06-09 03:41:05 tbox Exp $ -->

+<div class="cmdsynopsis"><p><code class="command">dnssec-keyfromlabel</code> {-l <em class="replaceable"><code>label</code></em>} [<code class="option">-3</code>] [<code class="option">-a <em class="replaceable"><code>algorithm</code></em></code>] [<code class="option">-A <em class="replaceable"><code>date/offset</code></em></code>] [<code class="option">-c <em class="replaceable"><code>class</code></em></code>] [<code class="option">-D <em class="replaceable"><code>date/offset</code></em></code>] [<code class="option">-E <em class="replaceable"><code>engine</code></em></code>] [<code class="option">-f <em class="replaceable"><code>flag</code></em></code>] [<code class="option">-G</code>] [<code class="option">-I <em class="replaceable"><code>date/offset</code></em></code>] [<code class="option">-k</code>] [<code class="option">-K <em class="replaceable"><code>directory</code></em></code>] [<code class="option">-n <em class="replaceable"><code>nametype</code></em></code>] [<code class="option">-P <em class="replaceable"><code>date/offset</code></em></code>] [<code class="option">-p <em class="replaceable"><code>protocol</code></em></code>] [<code class="option">-R <em class="replaceable"><code>date/offset</code></em></code>] [<code class="option">-t <em class="replaceable"><code>type</code></em></code>] [<code class="option">-v <em class="replaceable"><code>level</code></em></code>] [<code class="option">-y</code>] {name}</p></div>

+<a name="id2543494"></a><h2>DESCRIPTION</h2>

+<p>

+ The <code class="option">name</code> of the key is specified on the command

+ line. This must match the name of the zone for which the key is

+ being generated.

+ </p>

+<a name="id2543512"></a><h2>OPTIONS</h2>

+ <code class="option">algorithm</code> must be one of RSAMD5, RSASHA1,

+ DSA, NSEC3RSASHA1, NSEC3DSA, RSASHA256, RSASHA512 or ECCGOST.

+<dt><span class="term">-3</span></dt>

+<dd><p>

+ Use an NSEC3-capable algorithm to generate a DNSSEC key.

+ If this option is used and no algorithm is explicitly

+ set on the command line, NSEC3RSASHA1 will be used by

+ default.

+ </p></dd>

+<dt><span class="term">-E <em class="replaceable"><code>engine</code></em></span></dt>

+<dd><p>

+ Specifies the name of the crypto hardware (OpenSSL engine).

+ When compiled with PKCS#11 support it defaults to "pkcs11".

+ </p></dd>

+ Specifies the label of the key pair in the crypto hardware.

+ The label may be preceded by an optional OpenSSL engine name,

+ separated by a colon, as in "pkcs11:keylabel".

+ These values are case insensitive.

+ </p></dd>

+<dt><span class="term">-C</span></dt>

+<dd><p>

+ Compatibility mode: generates an old-style key, without

+ any metadata. By default, <span><strong class="command">dnssec-keyfromlabel</strong></span>

+ will include the key's creation date in the metadata stored

+ with the private key, and other dates may be set there as well

+ (publication date, activation date, etc). Keys that include

+ this data may be incompatible with older versions of BIND; the

+ <code class="option">-C</code> option suppresses them.

+ The only recognized flags are KSK (Key Signing Key) and REVOKE.

+ </p></dd>

+<dt><span class="term">-G</span></dt>

+<dd><p>

+ Generate a key, but do not publish it or sign with it. This

+ option is incompatible with -P and -A.

+ <span><strong class="command">dnssec-keyfromlabel</strong></span>.

+ </p></dd>

+<dt><span class="term">-K <em class="replaceable"><code>directory</code></em></span></dt>

+<dd><p>

+ Sets the directory in which the key files are to be written.

+ Sets the protocol value for the key. The protocol

+<dt><span class="term">-y</span></dt>

+<dd><p>

+ Allows DNSSEC key files to be generated even if the key ID

+ would collide with that of an existing key, in the event of

+ either key being revoked. (This is only safe to use if you

+ are sure you won't be using RFC 5011 trust anchor maintenance

+ with either of the keys involved.)

+ </p></dd>

+</dl></div>

+</div>

+<div class="refsect1" lang="en">

+<a name="id2543876"></a><h2>TIMING OPTIONS</h2>

+<p>

+ Dates can be expressed in the format YYYYMMDD or YYYYMMDDHHMMSS.

+ If the argument begins with a '+' or '-', it is interpreted as

+ an offset from the present time. For convenience, if such an offset

+ is followed by one of the suffixes 'y', 'mo', 'w', 'd', 'h', or 'mi',

+ then the offset is computed in years (defined as 365 24-hour days,

+ ignoring leap years), months (defined as 30 24-hour days), weeks,

+ days, hours, or minutes, respectively. Without a suffix, the offset

+ is computed in seconds.

+ </p>

+<div class="variablelist"><dl>

+<dt><span class="term">-P <em class="replaceable"><code>date/offset</code></em></span></dt>

+<dd><p>

+ Sets the date on which a key is to be published to the zone.

+ After that date, the key will be included in the zone but will

+ not be used to sign it. If not set, and if the -G option has

+ not been used, the default is "now".

+ </p></dd>

+<dt><span class="term">-A <em class="replaceable"><code>date/offset</code></em></span></dt>

+<dd><p>

+ Sets the date on which the key is to be activated. After that

+ date, the key will be included in the zone and used to sign

+ it. If not set, and if the -G option has not been used, the

+ default is "now".

+ </p></dd>

+<dt><span class="term">-R <em class="replaceable"><code>date/offset</code></em></span></dt>

+<dd><p>

+ Sets the date on which the key is to be revoked. After that

+ date, the key will be flagged as revoked. It will be included

+ in the zone and will be used to sign it.

+ </p></dd>

+<dt><span class="term">-I <em class="replaceable"><code>date/offset</code></em></span></dt>

+<dd><p>

+ Sets the date on which the key is to be retired. After that

+ date, the key will still be included in the zone, but it

+ will not be used to sign it.

+ </p></dd>

+<dt><span class="term">-D <em class="replaceable"><code>date/offset</code></em></span></dt>

+<dd><p>

+ Sets the date on which the key is to be deleted. After that

+ date, the key will no longer be included in the zone. (It

+ may remain in the key repository, however.)

+ </p></dd>

+<a name="id2544042"></a><h2>GENERATED KEY FILES</h2>

+ of the algorithm.

+ private key.

+ The <code class="filename">.private</code> file contains

+ algorithm-specific

+<a name="id2544115"></a><h2>SEE ALSO</h2>

+<a name="id2544148"></a><h2>AUTHOR</h2>

+.\" $Id: dnssec-keygen.8,v 1.55 2010-12-24 01:14:19 tbox Exp $

+\fBdnssec\-keygen\fR [\fB\-a\ \fR\fB\fIalgorithm\fR\fR] [\fB\-b\ \fR\fB\fIkeysize\fR\fR] [\fB\-n\ \fR\fB\fInametype\fR\fR] [\fB\-3\fR] [\fB\-A\ \fR\fB\fIdate/offset\fR\fR] [\fB\-C\fR] [\fB\-c\ \fR\fB\fIclass\fR\fR] [\fB\-D\ \fR\fB\fIdate/offset\fR\fR] [\fB\-E\ \fR\fB\fIengine\fR\fR] [\fB\-e\fR] [\fB\-f\ \fR\fB\fIflag\fR\fR] [\fB\-G\fR] [\fB\-g\ \fR\fB\fIgenerator\fR\fR] [\fB\-h\fR] [\fB\-I\ \fR\fB\fIdate/offset\fR\fR] [\fB\-i\ \fR\fB\fIinterval\fR\fR] [\fB\-K\ \fR\fB\fIdirectory\fR\fR] [\fB\-k\fR] [\fB\-P\ \fR\fB\fIdate/offset\fR\fR] [\fB\-p\ \fR\fB\fIprotocol\fR\fR] [\fB\-q\fR] [\fB\-R\ \fR\fB\fIdate/offset\fR\fR] [\fB\-r\ \fR\fB\fIrandomdev\fR\fR] [\fB\-S\ \fR\fB\fIkey\fR\fR] [\fB\-s\ \fR\fB\fIstrength\fR\fR] [\fB\-t\ \fR\fB\fItype\fR\fR] [\fB\-v\ \fR\fB\fIlevel\fR\fR] [\fB\-z\fR] {name}

+generates keys for DNSSEC (Secure DNS), as defined in RFC 2535 and RFC 4034. It can also generate keys for use with TSIG (Transaction Signatures) as defined in RFC 2845, or TKEY (Transaction Key) as defined in RFC 2930.

+must be one of RSAMD5, RSASHA1, DSA, NSEC3RSASHA1, NSEC3DSA, RSASHA256, RSASHA512 or ECCGOST. For TSIG/TKEY, the value must be DH (Diffie Hellman), HMAC\-MD5, HMAC\-SHA1, HMAC\-SHA224, HMAC\-SHA256, HMAC\-SHA384, or HMAC\-SHA512. These values are case insensitive.

+.sp

+If no algorithm is specified, then RSASHA1 will be used by default, unless the

+\fB\-3\fR

+option is specified, in which case NSEC3RSASHA1 will be used instead. (If

+\fB\-3\fR

+is used and an algorithm is specified, that algorithm will be checked for compatibility with NSEC3.)

+Note 2: DH, HMAC\-MD5, and HMAC\-SHA1 through HMAC\-SHA512 automatically set the \-T KEY option.

+.sp

+The key size does not need to be specified if using a default algorithm. The default key size is 1024 bits for zone signing keys (ZSK's) and 2048 bits for key signing keys (KSK's, generated with

+\fB\-f KSK\fR). However, if an algorithm is explicitly specified with the

+\fB\-a\fR, then there is no default key size, and the

+\fB\-b\fR

+must be used.

+\-3

+.RS 4

+Use an NSEC3\-capable algorithm to generate a DNSSEC key. If this option is used and no algorithm is explicitly set on the command line, NSEC3RSASHA1 will be used by default. Note that RSASHA256, RSASHA512 and ECCGOST algorithms are NSEC3\-capable.

+.RE

+.PP

+\-C

+.RS 4

+Compatibility mode: generates an old\-style key, without any metadata. By default,

+\fBdnssec\-keygen\fR

+will include the key's creation date in the metadata stored with the private key, and other dates may be set there as well (publication date, activation date, etc). Keys that include this data may be incompatible with older versions of BIND; the

+\fB\-C\fR

+option suppresses them.

+.RE

+.PP

+\-E \fIengine\fR

+.RS 4

+Uses a crypto hardware (OpenSSL engine) for random number and, when supported, key generation. When compiled with PKCS#11 support it defaults to pkcs11; the empty name resets it to no engine.

+.RE

+.PP

+Set the specified flag in the flag field of the KEY/DNSKEY record. The only recognized flags are KSK (Key Signing Key) and REVOKE.

+.RE

+.PP

+\-G

+.RS 4

+Generate a key, but do not publish it or sign with it. This option is incompatible with \-P and \-A.

+\-K \fIdirectory\fR

+.RS 4

+Sets the directory in which the key files are to be written.

+.RE

+.PP

+Deprecated in favor of \-T KEY.

+\-q

+.RS 4

+Quiet mode: Suppresses unnecessary output, including progress indication. Without this option, when

+\fBdnssec\-keygen\fR

+is run interactively to generate an RSA or DSA key pair, it will print a string of symbols to

+\fIstderr\fR

+indicating the progress of the key generation. A '.' indicates that a random number has been found which passed an initial sieve test; '+' means a number has passed a single round of the Miller\-Rabin primality test; a space means that the number has passed all the tests and is a satisfactory key.

+.RE

+.PP

+\-S \fIkey\fR

+.RS 4

+Create a new key which is an explicit successor to an existing key. The name, algorithm, size, and type of the key will be set to match the existing key. The activation date of the new key will be set to the inactivation date of the existing one. The publication date will be set to the activation date minus the prepublication interval, which defaults to 30 days.

+.RE

+.PP

+\-T \fIrrtype\fR

+.RS 4

+Specifies the resource record type to use for the key.

+\fBrrtype\fR

+must be either DNSKEY or KEY. The default is DNSKEY when using a DNSSEC algorithm, but it can be overridden to KEY for use with SIG(0).

+Using any TSIG algorithm (HMAC\-* or DH) forces this option to KEY.

+.RE

+.PP

+.SH "TIMING OPTIONS"

+.PP

+Dates can be expressed in the format YYYYMMDD or YYYYMMDDHHMMSS. If the argument begins with a '+' or '\-', it is interpreted as an offset from the present time. For convenience, if such an offset is followed by one of the suffixes 'y', 'mo', 'w', 'd', 'h', or 'mi', then the offset is computed in years (defined as 365 24\-hour days, ignoring leap years), months (defined as 30 24\-hour days), weeks, days, hours, or minutes, respectively. Without a suffix, the offset is computed in seconds.

+.PP

+\-P \fIdate/offset\fR

+.RS 4

+Sets the date on which a key is to be published to the zone. After that date, the key will be included in the zone but will not be used to sign it. If not set, and if the \-G option has not been used, the default is "now".

+.RE

+.PP

+\-A \fIdate/offset\fR

+.RS 4

+Sets the date on which the key is to be activated. After that date, the key will be included in the zone and used to sign it. If not set, and if the \-G option has not been used, the default is "now".

+.RE

+.PP

+\-R \fIdate/offset\fR

+.RS 4

+Sets the date on which the key is to be revoked. After that date, the key will be flagged as revoked. It will be included in the zone and will be used to sign it.

+.RE

+.PP

+\-I \fIdate/offset\fR

+.RS 4

+Sets the date on which the key is to be retired. After that date, the key will still be included in the zone, but it will not be used to sign it.

+.RE

+.PP

+\-D \fIdate/offset\fR

+.RS 4

+Sets the date on which the key is to be deleted. After that date, the key will no longer be included in the zone. (It may remain in the key repository, however.)

+.RE

+.PP

+\-i \fIinterval\fR

+.RS 4

+Sets the prepublication interval for a key. If set, then the publication and activation dates must be separated by at least this much time. If the activation date is specified but the publication date isn't, then the publication date will default to this much time before the activation date; conversely, if the publication date is specified but activation date isn't, then activation will be set to this much time after publication.

+.sp

+If the key is being created as an explicit successor to another key, then the default prepublication interval is 30 days; otherwise it is zero.

+.sp

+As with date offsets, if the argument is followed by one of the suffixes 'y', 'mo', 'w', 'd', 'h', or 'mi', then the interval is measured in years, months, weeks, days, hours, or minutes, respectively. Without a suffix, the interval is measured in seconds.

+.RE

+ * Portions Copyright (C) 2004-2010 Internet Systems Consortium, Inc. ("ISC")

+/* $Id: dnssec-keygen.c,v 1.115 2010-12-23 04:07:59 marka Exp $ */

+#include <ctype.h>

+#include <unistd.h>

+#include <dns/dnssec.h>

+#define DEFAULT_ALGORITHM "RSASHA1"

+#define DEFAULT_NSEC3_ALGORITHM "NSEC3RSASHA1"

+ISC_PLATFORM_NORETURN_PRE static void

+usage(void) ISC_PLATFORM_NORETURN_POST;

+

+static void progress(int p);

+ fprintf(stderr, " %s [options] name\n\n", program);

+ fprintf(stderr, " name: owner of the key\n");

+ fprintf(stderr, "Options:\n");

+ fprintf(stderr, " -K <directory>: write keys into directory\n");

+ fprintf(stderr, " -a <algorithm>:\n");

+ fprintf(stderr, " RSA | RSAMD5 | DSA | RSASHA1 | NSEC3RSASHA1"

+ " | NSEC3DSA |\n");

+ fprintf(stderr, " RSASHA256 | RSASHA512 | ECCGOST |\n");

+ fprintf(stderr, " DH | HMAC-MD5 | HMAC-SHA1 | HMAC-SHA224 | "

+ "HMAC-SHA256 | \n");

+ fprintf(stderr, " HMAC-SHA384 | HMAC-SHA512\n");

+ fprintf(stderr, " (default: RSASHA1, or "

+ "NSEC3RSASHA1 if using -3)\n");

+ fprintf(stderr, " -3: use NSEC3-capable algorithm\n");

+ fprintf(stderr, " -b <key size in bits>:\n");

+ fprintf(stderr, " RSAMD5:\t[512..%d]\n", MAX_RSA);

+ fprintf(stderr, " RSASHA1:\t[512..%d]\n", MAX_RSA);

+ fprintf(stderr, " NSEC3RSASHA1:\t[512..%d]\n", MAX_RSA);

+ fprintf(stderr, " RSASHA256:\t[512..%d]\n", MAX_RSA);

+ fprintf(stderr, " RSASHA512:\t[1024..%d]\n", MAX_RSA);

+ fprintf(stderr, " NSEC3DSA:\t[512..1024] and divisible "

+ "by 64\n");

+ fprintf(stderr, " ECCGOST:\tignored\n");

+ fprintf(stderr, " (if using the default algorithm, key size\n"

+ " defaults to 2048 for KSK, or 1024 for all "

+ "others)\n");

+ fprintf(stderr, " -n <nametype>: ZONE | HOST | ENTITY | "

+ "USER | OTHER\n");

+ fprintf(stderr, " (DNSKEY generation defaults to ZONE)\n");

+ fprintf(stderr, " -c <class>: (default: IN)\n");

+#ifdef USE_PKCS11

+ fprintf(stderr, " -E <engine name> (default \"pkcs11\")\n");

+#else

+ fprintf(stderr, " -E <engine name>\n");

+#endif

+ fprintf(stderr, " -e: use large exponent (RSAMD5/RSASHA1 only)\n");

+ fprintf(stderr, " -f <keyflag>: KSK | REVOKE\n");

+ fprintf(stderr, " -g <generator>: use specified generator "

+ "(DH only)\n");

+ fprintf(stderr, " -p <protocol>: (default: 3 [dnssec])\n");

+ fprintf(stderr, " -s <strength>: strength value this key signs DNS "

+ "records with (default: 0)\n");

+ fprintf(stderr, " -T <rrtype>: DNSKEY | KEY (default: DNSKEY; "

+ "use KEY for SIG(0))\n");

+ fprintf(stderr, " ECCGOST:\tignored\n");

+ "AUTHCONF | NOAUTHCONF | NOAUTH | NOCONF "

+ "(default: AUTHCONF)\n");

+

+ fprintf(stderr, " -h: print usage and exit\n");

+ fprintf(stderr, " -m <memory debugging mode>:\n");

+ fprintf(stderr, " usage | trace | record | size | mctx\n");

+ fprintf(stderr, " -v <level>: set verbosity level (0 - 10)\n");

+ fprintf(stderr, "Timing options:\n");

+ fprintf(stderr, " -P date/[+-]offset/none: set key publication date "

+ "(default: now)\n");

+ fprintf(stderr, " -A date/[+-]offset/none: set key activation date "

+ "(default: now)\n");

+ fprintf(stderr, " -R date/[+-]offset/none: set key "

+ "revocation date\n");

+ fprintf(stderr, " -I date/[+-]offset/none: set key "

+ "inactivation date\n");

+ fprintf(stderr, " -D date/[+-]offset/none: set key deletion date\n");

+ fprintf(stderr, " -G: generate key only; do not set -P or -A\n");

+ fprintf(stderr, " -C: generate a backward-compatible key, omitting "

+ "all dates\n");

+ fprintf(stderr, " -S <key>: generate a successor to an existing "

+ "key\n");

+ fprintf(stderr, " -i <interval>: prepublication interval for "

+ "successor key "

+ "(default: 30 days)\n");

+ "K<name>+<alg>+<id>.private\n");

+static isc_boolean_t

+dsa_size_ok(int size) {

+ return (ISC_TF(size >= 512 && size <= 1024 && size % 64 == 0));

+}

+

+static void

+progress(int p)

+{

+ char c = '*';

+

+ switch (p) {

+ case 0:

+ c = '.';

+ break;

+ case 1:

+ c = '+';

+ break;

+ case 2:

+ c = '*';

+ break;

+ case 3:

+ c = ' ';

+ break;

+ default:

+ break;

+ }

+ (void) putc(c, stderr);

+ (void) fflush(stderr);

+}

+

+ dst_key_t *key = NULL;

+ isc_uint16_t flags = 0, kskflag = 0, revflag = 0;

+ isc_boolean_t oldstyle = ISC_FALSE;

+ const char *directory = NULL;

+ const char *predecessor = NULL;

+ dst_key_t *prevkey = NULL;

+#ifdef USE_PKCS11

+ const char *engine = "pkcs11";

+#else

+ const char *engine = NULL;

+#endif

+ isc_boolean_t use_default = ISC_FALSE, use_nsec3 = ISC_FALSE;

+ isc_stdtime_t publish = 0, activate = 0, revoke = 0;

+ isc_stdtime_t inactive = 0, delete = 0;

+ isc_stdtime_t now;

+ int prepub = -1;

+ isc_boolean_t setpub = ISC_FALSE, setact = ISC_FALSE;

+ isc_boolean_t setrev = ISC_FALSE, setinact = ISC_FALSE;

+ isc_boolean_t setdel = ISC_FALSE;

+ isc_boolean_t unsetpub = ISC_FALSE, unsetact = ISC_FALSE;

+ isc_boolean_t unsetrev = ISC_FALSE, unsetinact = ISC_FALSE;

+ isc_boolean_t unsetdel = ISC_FALSE;

+ isc_boolean_t genonly = ISC_FALSE;

+ isc_boolean_t quiet = ISC_FALSE;

+ isc_boolean_t show_progress = ISC_FALSE;

+ unsigned char c;

+ /*

+ * Process memory debugging argument first.

+ */

+#define CMDLINE_FLAGS "3A:a:b:Cc:D:d:E:eFf:Gg:hI:i:K:km:n:P:p:qR:r:S:s:T:t:v:"

+ while ((ch = isc_commandline_parse(argc, argv, CMDLINE_FLAGS)) != -1) {

+ switch (ch) {

+ case 'm':

+ if (strcasecmp(isc_commandline_argument, "record") == 0)

+ isc_mem_debugging |= ISC_MEM_DEBUGRECORD;

+ if (strcasecmp(isc_commandline_argument, "trace") == 0)

+ isc_mem_debugging |= ISC_MEM_DEBUGTRACE;

+ if (strcasecmp(isc_commandline_argument, "usage") == 0)

+ isc_mem_debugging |= ISC_MEM_DEBUGUSAGE;

+ if (strcasecmp(isc_commandline_argument, "size") == 0)

+ isc_mem_debugging |= ISC_MEM_DEBUGSIZE;

+ if (strcasecmp(isc_commandline_argument, "mctx") == 0)

+ isc_mem_debugging |= ISC_MEM_DEBUGCTX;

+ break;

+ default:

+ break;

+ }

+ }

+ isc_commandline_reset = ISC_TRUE;

+

+ RUNTIME_CHECK(isc_mem_create(0, 0, &mctx) == ISC_R_SUCCESS);

+

+ isc_stdtime_get(&now);

+

+ while ((ch = isc_commandline_parse(argc, argv, CMDLINE_FLAGS)) != -1) {

+ case '3':

+ use_nsec3 = ISC_TRUE;

+ break;

+ case 'C':

+ oldstyle = ISC_TRUE;

+ break;

+ case 'E':

+ engine = isc_commandline_argument;

+ break;

+ c = (unsigned char)(isc_commandline_argument[0]);

+ if (toupper(c) == 'K')

+ kskflag = DNS_KEYFLAG_KSK;

+ else if (toupper(c) == 'R')

+ revflag = DNS_KEYFLAG_REVOKE;

+ case 'K':

+ directory = isc_commandline_argument;

+ ret = try_dir(directory);

+ if (ret != ISC_R_SUCCESS)

+ fatal("cannot open directory %s: %s",

+ directory, isc_result_totext(ret));

+ break;

+ fatal("The -k option has been deprecated.\n"

+ "To generate a key-signing key, use -f KSK.\n"

+ "To generate a key with TYPE=KEY, use -T KEY.\n");

+ case 'm':

+ case 'q':

+ quiet = ISC_TRUE;

+ break;

+ case 'r':

+ setup_entropy(mctx, isc_commandline_argument, &ectx);

+ break;

+ case 'T':

+ if (strcasecmp(isc_commandline_argument, "KEY") == 0)

+ options |= DST_TYPE_KEY;

+ else if (strcasecmp(isc_commandline_argument,

+ "DNSKEY") == 0)

+ /* default behavior */

+ ;

+ else

+ fatal("unknown type '%s'",

+ isc_commandline_argument);

+ break;

+ case 't':

+ type = isc_commandline_argument;

+ case 'z':

+ /* already the default */

+ break;

+ case 'G':

+ genonly = ISC_TRUE;

+ break;

+ case 'P':

+ if (setpub || unsetpub)

+ fatal("-P specified more than once");

+

+ if (strcasecmp(isc_commandline_argument, "none")) {

+ setpub = ISC_TRUE;

+ publish = strtotime(isc_commandline_argument,

+ now, now);

+ } else {

+ unsetpub = ISC_TRUE;

+ }

+ break;

+ case 'A':

+ if (setact || unsetact)

+ fatal("-A specified more than once");

+

+ if (strcasecmp(isc_commandline_argument, "none")) {

+ setact = ISC_TRUE;

+ activate = strtotime(isc_commandline_argument,

+ now, now);

+ } else {

+ unsetact = ISC_TRUE;

+ }

+ break;

+ case 'R':

+ if (setrev || unsetrev)

+ fatal("-R specified more than once");

+

+ if (strcasecmp(isc_commandline_argument, "none")) {

+ setrev = ISC_TRUE;

+ revoke = strtotime(isc_commandline_argument,

+ now, now);

+ } else {

+ unsetrev = ISC_TRUE;

+ }

+ break;

+ case 'I':

+ if (setinact || unsetinact)

+ fatal("-I specified more than once");

+

+ if (strcasecmp(isc_commandline_argument, "none")) {

+ setinact = ISC_TRUE;

+ inactive = strtotime(isc_commandline_argument,

+ now, now);

+ } else {

+ unsetinact = ISC_TRUE;

+ }

+ break;

+ case 'D':

+ if (setdel || unsetdel)

+ fatal("-D specified more than once");

+

+ if (strcasecmp(isc_commandline_argument, "none")) {

+ setdel = ISC_TRUE;

+ delete = strtotime(isc_commandline_argument,

+ now, now);

+ } else {

+ unsetdel = ISC_TRUE;

+ }

+ break;

+ case 'S':

+ predecessor = isc_commandline_argument;

+ break;

+ case 'i':

+ prepub = strtottl(isc_commandline_argument);

+ break;

+ case 'F':

+ /* Reserved for FIPS mode */

+ /* FALLTHROUGH */

+ /* FALLTHROUGH */

+ if (!isatty(0))

+ quiet = ISC_TRUE;

+

+ ret = dst_lib_init2(mctx, ectx, engine,

+ ISC_ENTROPY_BLOCKING | ISC_ENTROPY_GOODONLY);

+ fatal("could not initialize dst: %s",

+ isc_result_totext(ret));

+ if (predecessor == NULL) {

+ if (prepub == -1)

+ prepub = 0;

+

+ if (argc < isc_commandline_index + 1)

+ fatal("the key name was not specified");

+ if (argc > isc_commandline_index + 1)

+ fatal("extraneous arguments");

+

+ dns_fixedname_init(&fname);

+ name = dns_fixedname_name(&fname);

+ isc_buffer_init(&buf, argv[isc_commandline_index],

+ strlen(argv[isc_commandline_index]));

+ isc_buffer_add(&buf, strlen(argv[isc_commandline_index]));

+ ret = dns_name_fromtext(name, &buf, dns_rootname, 0, NULL);

+ fatal("invalid key name %s: %s",

+ argv[isc_commandline_index],

+ isc_result_totext(ret));

+

+ if (algname == NULL) {

+ use_default = ISC_TRUE;

+ if (use_nsec3)

+ algname = strdup(DEFAULT_NSEC3_ALGORITHM);

+ else

+ algname = strdup(DEFAULT_ALGORITHM);

+ if (verbose > 0)

+ fprintf(stderr, "no algorithm specified; "

+ "defaulting to %s\n", algname);

+ }

+ if (strcasecmp(algname, "RSA") == 0) {

+ fprintf(stderr, "The use of RSA (RSAMD5) is not "

+ "recommended.\nIf you still wish to "

+ "use RSA (RSAMD5) please specify "

+ "\"-a RSAMD5\"\n");

+ return (1);

+ } else if (strcasecmp(algname, "HMAC-MD5") == 0)

+ alg = DST_ALG_HMACMD5;

+ else if (strcasecmp(algname, "HMAC-SHA1") == 0)

+ alg = DST_ALG_HMACSHA1;

+ else if (strcasecmp(algname, "HMAC-SHA224") == 0)

+ alg = DST_ALG_HMACSHA224;

+ else if (strcasecmp(algname, "HMAC-SHA256") == 0)

+ alg = DST_ALG_HMACSHA256;

+ else if (strcasecmp(algname, "HMAC-SHA384") == 0)

+ alg = DST_ALG_HMACSHA384;

+ else if (strcasecmp(algname, "HMAC-SHA512") == 0)

+ alg = DST_ALG_HMACSHA512;

+ else {

+ r.base = algname;

+ r.length = strlen(algname);

+ ret = dns_secalg_fromtext(&alg, &r);

+ if (ret != ISC_R_SUCCESS)

+ fatal("unknown algorithm %s", algname);

+ if (alg == DST_ALG_DH)

+ options |= DST_TYPE_KEY;

+ if (use_nsec3 &&

+ alg != DST_ALG_NSEC3DSA && alg != DST_ALG_NSEC3RSASHA1 &&

+ alg != DST_ALG_RSASHA256 && alg!= DST_ALG_RSASHA512 &&

+ alg != DST_ALG_ECCGOST) {

+ fatal("%s is incompatible with NSEC3; "

+ "do not use the -3 option", algname);

+ }

+

+ if (type != NULL && (options & DST_TYPE_KEY) != 0) {

+ if (strcasecmp(type, "NOAUTH") == 0)

+ flags |= DNS_KEYTYPE_NOAUTH;

+ else if (strcasecmp(type, "NOCONF") == 0)

+ flags |= DNS_KEYTYPE_NOCONF;

+ else if (strcasecmp(type, "NOAUTHCONF") == 0) {

+ flags |= (DNS_KEYTYPE_NOAUTH |

+ DNS_KEYTYPE_NOCONF);

+ if (size < 0)

+ size = 0;

+ }

+ else if (strcasecmp(type, "AUTHCONF") == 0)

+ /* nothing */;

+ else

+ fatal("invalid type %s", type);

+ }

+

+ if (size < 0) {

+ if (use_default) {

+ if ((kskflag & DNS_KEYFLAG_KSK) != 0)

+ size = 2048;

+ else

+ size = 1024;

+ if (verbose > 0)

+ fprintf(stderr, "key size not "

+ "specified; defaulting "

+ "to %d\n", size);

+ } else if (alg != DST_ALG_ECCGOST)

+ fatal("key size not specified (-b option)");

+ }

+

+ if (!oldstyle && prepub > 0) {

+ if (setpub && setact && (activate - prepub) < publish)

+ fatal("Activation and publication dates "

+ "are closer together than the\n\t"

+ "prepublication interval.");

+

+ if (!setpub && !setact) {

+ setpub = setact = ISC_TRUE;

+ publish = now;

+ activate = now + prepub;

+ } else if (setpub && !setact) {

+ setact = ISC_TRUE;

+ activate = publish + prepub;

+ } else if (setact && !setpub) {

+ setpub = ISC_TRUE;

+ publish = activate - prepub;

+ }

+

+ if ((activate - prepub) < now)

+ fatal("Time until activation is shorter "

+ "than the\n\tprepublication interval.");

+ }

+ } else {

+ char keystr[DST_KEY_FORMATSIZE];

+ isc_stdtime_t when;

+ int major, minor;

+

+ if (prepub == -1)

+ prepub = (30 * 86400);

+

+ if (algname != NULL)

+ fatal("-S and -a cannot be used together");

+ if (size >= 0)

+ fatal("-S and -b cannot be used together");

+ if (nametype != NULL)

+ fatal("-S and -n cannot be used together");

+ if (type != NULL)

+ fatal("-S and -t cannot be used together");

+ if (setpub || unsetpub)

+ fatal("-S and -P cannot be used together");

+ if (setact || unsetact)

+ fatal("-S and -A cannot be used together");

+ if (use_nsec3)

+ fatal("-S and -3 cannot be used together");

+ if (oldstyle)

+ fatal("-S and -C cannot be used together");

+ if (genonly)

+ fatal("-S and -G cannot be used together");

+

+ ret = dst_key_fromnamedfile(predecessor, directory,

+ DST_TYPE_PUBLIC | DST_TYPE_PRIVATE,

+ mctx, &prevkey);

+ if (ret != ISC_R_SUCCESS)

+ fatal("Invalid keyfile %s: %s",

+ filename, isc_result_totext(ret));

+ if (!dst_key_isprivate(prevkey))

+ fatal("%s is not a private key", filename);

+

+ name = dst_key_name(prevkey);

+ alg = dst_key_alg(prevkey);

+ size = dst_key_size(prevkey);

+ flags = dst_key_flags(prevkey);

+

+ dst_key_format(prevkey, keystr, sizeof(keystr));

+ dst_key_getprivateformat(prevkey, &major, &minor);

+ if (major != DST_MAJOR_VERSION || minor < DST_MINOR_VERSION)

+ fatal("Key %s has incompatible format version %d.%d\n\t"

+ "It is not possible to generate a successor key.",

+ keystr, major, minor);

+

+ ret = dst_key_gettime(prevkey, DST_TIME_ACTIVATE, &when);

+ if (ret != ISC_R_SUCCESS)

+ fatal("Key %s has no activation date.\n\t"

+ "You must use dnssec-settime -A to set one "

+ "before generating a successor.", keystr);

+

+ ret = dst_key_gettime(prevkey, DST_TIME_INACTIVE, &activate);

+ if (ret != ISC_R_SUCCESS)

+ fatal("Key %s has no inactivation date.\n\t"

+ "You must use dnssec-settime -I to set one "

+ "before generating a successor.", keystr);

+

+ publish = activate - prepub;

+ if (publish < now)

+ fatal("Key %s becomes inactive\n\t"

+ "sooner than the prepublication period "

+ "for the new key ends.\n\t"

+ "Either change the inactivation date with "

+ "dnssec-settime -I,\n\t"

+ "or use the -i option to set a shorter "

+ "prepublication interval.", keystr);

+

+ ret = dst_key_gettime(prevkey, DST_TIME_DELETE, &when);

+ if (ret != ISC_R_SUCCESS)

+ fprintf(stderr, "%s: WARNING: Key %s has no removal "

+ "date;\n\t it will remain in the zone "

+ "indefinitely after rollover.\n\t "

+ "You can use dnssec-settime -D to "

+ "change this.\n", program, keystr);

+

+ setpub = setact = ISC_TRUE;

+ }

+ case DST_ALG_ECCGOST:

+ break;

+ options |= DST_TYPE_KEY;

+ options |= DST_TYPE_KEY;

+ options |= DST_TYPE_KEY;

+ options |= DST_TYPE_KEY;

+ options |= DST_TYPE_KEY;

+ options |= DST_TYPE_KEY;

+ alg == DNS_KEYALG_RSASHA512 || alg == DST_ALG_ECCGOST) &&

+ rsa_exp != 0)

+ if (directory == NULL)

+ directory = ".";

+

+ else if ((flags & DNS_KEYOWNER_ZONE) != 0) { /* DNSKEY */

+ flags |= kskflag;

+ flags |= revflag;

+ }

+ show_progress = ISC_TRUE;

+

+

+ case DST_ALG_ECCGOST:

+ show_progress = ISC_TRUE;

+ /* fall through */

+

+ if (!quiet && show_progress) {

+ fprintf(stderr, "Generating key pair.");

+ ret = dst_key_generate2(name, alg, size, param, flags,

+ protocol, rdclass, mctx, &key,

+ &progress);

+ putc('\n', stderr);

+ fflush(stderr);

+ } else {

+ ret = dst_key_generate2(name, alg, size, param, flags,

+ protocol, rdclass, mctx, &key,

+ NULL);

+ }

+

+ char algstr[DNS_SECALG_FORMATSIZE];

+ dns_secalg_format(alg, algstr, sizeof(algstr));

+ /* NOTREACHED */

+ * Set key timing metadata (unless using -C)

+ *

+ * Creation date is always set to "now".

+ *

+ * For a new key without an explicit predecessor, publish

+ * and activation dates are set to "now" by default, but

+ * can both be overridden.

+ *

+ * For a successor key, activation is set to match the

+ * predecessor's inactivation date. Publish is set to 30

+ * days earlier than that (XXX: this should be configurable).

+ * If either of the resulting dates are in the past, that's

+ * an error; the inactivation date of the predecessor key

+ * must be updated before a successor key can be created.

+ if (!oldstyle) {

+ dst_key_settime(key, DST_TIME_CREATED, now);

+

+ if (genonly && (setpub || setact))

+ fatal("cannot use -G together with "

+ "-P or -A options");

+

+ if (setpub)

+ dst_key_settime(key, DST_TIME_PUBLISH, publish);

+ else if (setact)

+ dst_key_settime(key, DST_TIME_PUBLISH,

+ activate);

+ else if (!genonly && !unsetpub)

+ dst_key_settime(key, DST_TIME_PUBLISH, now);

+

+ if (setact)

+ dst_key_settime(key, DST_TIME_ACTIVATE,

+ activate);

+ else if (!genonly && !unsetact)

+ dst_key_settime(key, DST_TIME_ACTIVATE, now);

+

+ if (setrev) {

+ if (kskflag == 0)

+ fprintf(stderr, "%s: warning: Key is "

+ "not flagged as a KSK, but -R "

+ "was used. Revoking a ZSK is "

+ "legal, but undefined.\n",

+ program);

+ dst_key_settime(key, DST_TIME_REVOKE, revoke);

+ }

+

+ if (setinact)

+ dst_key_settime(key, DST_TIME_INACTIVE,

+ inactive);

+

+ if (setdel)

+ dst_key_settime(key, DST_TIME_DELETE, delete);

+ } else {

+ if (setpub || setact || setrev || setinact ||

+ setdel || unsetpub || unsetact ||

+ unsetrev || unsetinact || unsetdel || genonly)

+ fatal("cannot use -C together with "

+ "-P, -A, -R, -I, -D, or -G options");

+ /*

+ * Compatibility mode: Private-key-format

+ * should be set to 1.2.

+ */

+ dst_key_setprivateformat(key, 1, 2);

+ }

+

+ /*

+ * Do not overwrite an existing key, or create a key

+ * if there is a risk of ID collision due to this key

+ * or another key being revoked.

+ */

+ if (key_collision(dst_key_id(key), name, directory,

+ alg, mctx, NULL)) {

+ if (null_key) {

+ dst_key_free(&key);

+ }

+

+ dst_key_buildfilename(key, 0, directory, &buf);

+ "%s: %s already exists, or might "

+ "collide with another key upon "

+ "revokation. Generating a new key\n",

+

+ fatal("cannot generate a null key due to possible key ID "

+ "collision");

+ ret = dst_key_tofile(key, options, directory);

+ char keystr[DST_KEY_FORMATSIZE];

+ dst_key_format(key, keystr, sizeof(keystr));

+ if (prevkey != NULL)

+ dst_key_free(&prevkey);

+<!-- $Id: dnssec-keygen.docbook,v 1.36 2010-12-23 04:07:59 marka Exp $ -->

+ <arg><option>-a <replaceable class="parameter">algorithm</replaceable></option></arg>

+ <arg ><option>-b <replaceable class="parameter">keysize</replaceable></option></arg>

+ <arg><option>-n <replaceable class="parameter">nametype</replaceable></option></arg>

+ <arg><option>-3</option></arg>

+ <arg><option>-A <replaceable class="parameter">date/offset</replaceable></option></arg>

+ <arg><option>-C</option></arg>

+ <arg><option>-D <replaceable class="parameter">date/offset</replaceable></option></arg>

+ <arg><option>-E <replaceable class="parameter">engine</replaceable></option></arg>

+ <arg><option>-G</option></arg>

+ <arg><option>-I <replaceable class="parameter">date/offset</replaceable></option></arg>

+ <arg><option>-i <replaceable class="parameter">interval</replaceable></option></arg>

+ <arg><option>-K <replaceable class="parameter">directory</replaceable></option></arg>

+ <arg><option>-P <replaceable class="parameter">date/offset</replaceable></option></arg>

+ <arg><option>-q</option></arg>

+ <arg><option>-R <replaceable class="parameter">date/offset</replaceable></option></arg>

+ <arg><option>-S <replaceable class="parameter">key</replaceable></option></arg>

+ <arg><option>-z</option></arg>

+ TSIG (Transaction Signatures) as defined in RFC 2845, or TKEY

+ (Transaction Key) as defined in RFC 2930.

+ DSA, NSEC3RSASHA1, NSEC3DSA, RSASHA256, RSASHA512 or ECCGOST.

+ For TSIG/TKEY, the value must

+ If no algorithm is specified, then RSASHA1 will be used by

+ default, unless the <option>-3</option> option is specified,

+ in which case NSEC3RSASHA1 will be used instead. (If

+ <option>-3</option> is used and an algorithm is specified,

+ that algorithm will be checked for compatibility with NSEC3.)

+ </para>

+ <para>

+ Note 2: DH, HMAC-MD5, and HMAC-SHA1 through HMAC-SHA512

+ automatically set the -T KEY option.

+ <para>

+ The key size does not need to be specified if using a default

+ algorithm. The default key size is 1024 bits for zone signing

+ keys (ZSK's) and 2048 bits for key signing keys (KSK's,

+ generated with <option>-f KSK</option>). However, if an

+ algorithm is explicitly specified with the <option>-a</option>,

+ then there is no default key size, and the <option>-b</option>

+ must be used.

+ </para>

+ <term>-3</term>

+ <listitem>

+ <para>

+ Use an NSEC3-capable algorithm to generate a DNSSEC key.

+ If this option is used and no algorithm is explicitly

+ set on the command line, NSEC3RSASHA1 will be used by

+ default. Note that RSASHA256, RSASHA512 and ECCGOST algorithms

+ are NSEC3-capable.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-C</term>

+ <listitem>

+ <para>

+ Compatibility mode: generates an old-style key, without

+ any metadata. By default, <command>dnssec-keygen</command>

+ will include the key's creation date in the metadata stored

+ with the private key, and other dates may be set there as well

+ (publication date, activation date, etc). Keys that include

+ this data may be incompatible with older versions of BIND; the

+ <option>-C</option> option suppresses them.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-E <replaceable class="parameter">engine</replaceable></term>

+ <listitem>

+ <para>

+ Uses a crypto hardware (OpenSSL engine) for random number

+ and, when supported, key generation. When compiled with PKCS#11

+ support it defaults to pkcs11; the empty name resets it to

+ no engine.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ The only recognized flags are KSK (Key Signing Key) and REVOKE.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-G</term>

+ <listitem>

+ <para>

+ Generate a key, but do not publish it or sign with it. This

+ option is incompatible with -P and -A.

+ <term>-K <replaceable class="parameter">directory</replaceable></term>

+ <listitem>

+ <para>

+ Sets the directory in which the key files are to be written.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ Deprecated in favor of -T KEY.

+ <term>-q</term>

+ <listitem>

+ <para>

+ Quiet mode: Suppresses unnecessary output, including

+ progress indication. Without this option, when

+ <command>dnssec-keygen</command> is run interactively

+ to generate an RSA or DSA key pair, it will print a string

+ of symbols to <filename>stderr</filename> indicating the

+ progress of the key generation. A '.' indicates that a

+ random number has been found which passed an initial

+ sieve test; '+' means a number has passed a single

+ round of the Miller-Rabin primality test; a space

+ means that the number has passed all the tests and is

+ a satisfactory key.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-S <replaceable class="parameter">key</replaceable></term>

+ <listitem>

+ <para>

+ Create a new key which is an explicit successor to an

+ existing key. The name, algorithm, size, and type of the

+ key will be set to match the existing key. The activation

+ date of the new key will be set to the inactivation date of

+ the existing one. The publication date will be set to the

+ activation date minus the prepublication interval, which

+ defaults to 30 days.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-T <replaceable class="parameter">rrtype</replaceable></term>

+ <listitem>

+ <para>

+ Specifies the resource record type to use for the key.

+ <option>rrtype</option> must be either DNSKEY or KEY. The

+ default is DNSKEY when using a DNSSEC algorithm, but it can be

+ overridden to KEY for use with SIG(0).

+ <para>

+ </para>

+ Using any TSIG algorithm (HMAC-* or DH) forces this option

+ to KEY.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <title>TIMING OPTIONS</title>

+

+ <para>

+ Dates can be expressed in the format YYYYMMDD or YYYYMMDDHHMMSS.

+ If the argument begins with a '+' or '-', it is interpreted as

+ an offset from the present time. For convenience, if such an offset

+ is followed by one of the suffixes 'y', 'mo', 'w', 'd', 'h', or 'mi',

+ then the offset is computed in years (defined as 365 24-hour days,

+ ignoring leap years), months (defined as 30 24-hour days), weeks,

+ days, hours, or minutes, respectively. Without a suffix, the offset

+ is computed in seconds.

+ </para>

+

+ <variablelist>

+ <varlistentry>

+ <term>-P <replaceable class="parameter">date/offset</replaceable></term>

+ <listitem>

+ <para>

+ Sets the date on which a key is to be published to the zone.

+ After that date, the key will be included in the zone but will

+ not be used to sign it. If not set, and if the -G option has

+ not been used, the default is "now".

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-A <replaceable class="parameter">date/offset</replaceable></term>

+ <listitem>

+ <para>

+ Sets the date on which the key is to be activated. After that

+ date, the key will be included in the zone and used to sign

+ it. If not set, and if the -G option has not been used, the

+ default is "now".

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-R <replaceable class="parameter">date/offset</replaceable></term>

+ <listitem>

+ <para>

+ Sets the date on which the key is to be revoked. After that

+ date, the key will be flagged as revoked. It will be included

+ in the zone and will be used to sign it.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-I <replaceable class="parameter">date/offset</replaceable></term>

+ <listitem>

+ <para>

+ Sets the date on which the key is to be retired. After that

+ date, the key will still be included in the zone, but it

+ will not be used to sign it.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-D <replaceable class="parameter">date/offset</replaceable></term>

+ <listitem>

+ <para>

+ Sets the date on which the key is to be deleted. After that

+ date, the key will no longer be included in the zone. (It

+ may remain in the key repository, however.)

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-i <replaceable class="parameter">interval</replaceable></term>

+ <listitem>

+ <para>

+ Sets the prepublication interval for a key. If set, then

+ the publication and activation dates must be separated by at least

+ this much time. If the activation date is specified but the

+ publication date isn't, then the publication date will default

+ to this much time before the activation date; conversely, if

+ the publication date is specified but activation date isn't,

+ then activation will be set to this much time after publication.

+ </para>

+ <para>

+ If the key is being created as an explicit successor to another

+ key, then the default prepublication interval is 30 days;

+ otherwise it is zero.

+ </para>

+ <para>

+ As with date offsets, if the argument is followed by one of

+ the suffixes 'y', 'mo', 'w', 'd', 'h', or 'mi', then the

+ interval is measured in years, months, weeks, days, hours,

+ or minutes, respectively. Without a suffix, the interval is

+ measured in seconds.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ </variablelist>

+ </refsect1>

+

+

+ <refsect1>

+<!-- $Id: dnssec-keygen.html,v 1.47 2010-12-24 01:14:20 tbox Exp $ -->

+<div class="cmdsynopsis"><p><code class="command">dnssec-keygen</code> [<code class="option">-a <em class="replaceable"><code>algorithm</code></em></code>] [<code class="option">-b <em class="replaceable"><code>keysize</code></em></code>] [<code class="option">-n <em class="replaceable"><code>nametype</code></em></code>] [<code class="option">-3</code>] [<code class="option">-A <em class="replaceable"><code>date/offset</code></em></code>] [<code class="option">-C</code>] [<code class="option">-c <em class="replaceable"><code>class</code></em></code>] [<code class="option">-D <em class="replaceable"><code>date/offset</code></em></code>] [<code class="option">-E <em class="replaceable"><code>engine</code></em></code>] [<code class="option">-e</code>] [<code class="option">-f <em class="replaceable"><code>flag</code></em></code>] [<code class="option">-G</code>] [<code class="option">-g <em class="replaceable"><code>generator</code></em></code>] [<code class="option">-h</code>] [<code class="option">-I <em class="replaceable"><code>date/offset</code></em></code>] [<code class="option">-i <em class="replaceable"><code>interval</code></em></code>] [<code class="option">-K <em class="replaceable"><code>directory</code></em></code>] [<code class="option">-k</code>] [<code class="option">-P <em class="replaceable"><code>date/offset</code></em></code>] [<code class="option">-p <em class="replaceable"><code>protocol</code></em></code>] [<code class="option">-q</code>] [<code class="option">-R <em class="replaceable"><code>date/offset</code></em></code>] [<code class="option">-r <em class="replaceable"><code>randomdev</code></em></code>] [<code class="option">-S <em class="replaceable"><code>key</code></em></code>] [<code class="option">-s <em class="replaceable"><code>strength</code></em></code>] [<code class="option">-t <em class="replaceable"><code>type</code></em></code>] [<code class="option">-v <em class="replaceable"><code>level</code></em></code>] [<code class="option">-z</code>] {name}</p></div>

+<a name="id2543578"></a><h2>DESCRIPTION</h2>

+ TSIG (Transaction Signatures) as defined in RFC 2845, or TKEY

+ (Transaction Key) as defined in RFC 2930.

+<a name="id2543596"></a><h2>OPTIONS</h2>

+ DSA, NSEC3RSASHA1, NSEC3DSA, RSASHA256, RSASHA512 or ECCGOST.

+ For TSIG/TKEY, the value must

+ If no algorithm is specified, then RSASHA1 will be used by

+ default, unless the <code class="option">-3</code> option is specified,

+ in which case NSEC3RSASHA1 will be used instead. (If

+ <code class="option">-3</code> is used and an algorithm is specified,

+ that algorithm will be checked for compatibility with NSEC3.)

+ </p>

+<p>

+ Note 2: DH, HMAC-MD5, and HMAC-SHA1 through HMAC-SHA512

+ automatically set the -T KEY option.

+<dd>

+<p>

+ </p>

+<p>

+ The key size does not need to be specified if using a default

+ algorithm. The default key size is 1024 bits for zone signing

+ keys (ZSK's) and 2048 bits for key signing keys (KSK's,

+ generated with <code class="option">-f KSK</code>). However, if an

+ algorithm is explicitly specified with the <code class="option">-a</code>,

+ then there is no default key size, and the <code class="option">-b</code>

+ must be used.

+ </p>

+</dd>

+<dt><span class="term">-3</span></dt>

+<dd><p>

+ Use an NSEC3-capable algorithm to generate a DNSSEC key.

+ If this option is used and no algorithm is explicitly

+ set on the command line, NSEC3RSASHA1 will be used by

+ default. Note that RSASHA256, RSASHA512 and ECCGOST algorithms

+ are NSEC3-capable.

+ </p></dd>

+<dt><span class="term">-C</span></dt>

+<dd><p>

+ Compatibility mode: generates an old-style key, without

+ any metadata. By default, <span><strong class="command">dnssec-keygen</strong></span>

+ will include the key's creation date in the metadata stored

+ with the private key, and other dates may be set there as well

+ (publication date, activation date, etc). Keys that include

+ this data may be incompatible with older versions of BIND; the

+ <code class="option">-C</code> option suppresses them.

+ </p></dd>

+<dt><span class="term">-E <em class="replaceable"><code>engine</code></em></span></dt>

+<dd><p>

+ Uses a crypto hardware (OpenSSL engine) for random number

+ and, when supported, key generation. When compiled with PKCS#11

+ support it defaults to pkcs11; the empty name resets it to

+ no engine.

+ </p></dd>

+ The only recognized flags are KSK (Key Signing Key) and REVOKE.

+ </p></dd>

+<dt><span class="term">-G</span></dt>

+<dd><p>

+ Generate a key, but do not publish it or sign with it. This

+ option is incompatible with -P and -A.

+<dt><span class="term">-K <em class="replaceable"><code>directory</code></em></span></dt>

+<dd><p>

+ Sets the directory in which the key files are to be written.

+ </p></dd>

+ Deprecated in favor of -T KEY.

+<dt><span class="term">-q</span></dt>

+<dd><p>

+ Quiet mode: Suppresses unnecessary output, including

+ progress indication. Without this option, when

+ <span><strong class="command">dnssec-keygen</strong></span> is run interactively

+ to generate an RSA or DSA key pair, it will print a string

+ of symbols to <code class="filename">stderr</code> indicating the

+ progress of the key generation. A '.' indicates that a

+ random number has been found which passed an initial

+ sieve test; '+' means a number has passed a single

+ round of the Miller-Rabin primality test; a space

+ means that the number has passed all the tests and is

+ a satisfactory key.

+ </p></dd>

+<dt><span class="term">-S <em class="replaceable"><code>key</code></em></span></dt>

+<dd><p>

+ Create a new key which is an explicit successor to an

+ existing key. The name, algorithm, size, and type of the

+ key will be set to match the existing key. The activation

+ date of the new key will be set to the inactivation date of

+ the existing one. The publication date will be set to the

+ activation date minus the prepublication interval, which

+ defaults to 30 days.

+ </p></dd>

+<dt><span class="term">-T <em class="replaceable"><code>rrtype</code></em></span></dt>

+<dd>

+<p>

+ Specifies the resource record type to use for the key.

+ <code class="option">rrtype</code> must be either DNSKEY or KEY. The

+ default is DNSKEY when using a DNSSEC algorithm, but it can be

+ overridden to KEY for use with SIG(0).

+ </p>

+<p>

+ </p>

+<p>

+ Using any TSIG algorithm (HMAC-* or DH) forces this option

+ to KEY.

+ </p>

+</dd>

+<a name="id2544301"></a><h2>TIMING OPTIONS</h2>

+<p>

+ Dates can be expressed in the format YYYYMMDD or YYYYMMDDHHMMSS.

+ If the argument begins with a '+' or '-', it is interpreted as

+ an offset from the present time. For convenience, if such an offset

+ is followed by one of the suffixes 'y', 'mo', 'w', 'd', 'h', or 'mi',

+ then the offset is computed in years (defined as 365 24-hour days,

+ ignoring leap years), months (defined as 30 24-hour days), weeks,

+ days, hours, or minutes, respectively. Without a suffix, the offset

+ is computed in seconds.

+ </p>

+<div class="variablelist"><dl>

+<dt><span class="term">-P <em class="replaceable"><code>date/offset</code></em></span></dt>

+<dd><p>

+ Sets the date on which a key is to be published to the zone.

+ After that date, the key will be included in the zone but will

+ not be used to sign it. If not set, and if the -G option has

+ not been used, the default is "now".

+ </p></dd>

+<dt><span class="term">-A <em class="replaceable"><code>date/offset</code></em></span></dt>

+<dd><p>

+ Sets the date on which the key is to be activated. After that

+ date, the key will be included in the zone and used to sign

+ it. If not set, and if the -G option has not been used, the

+ default is "now".

+ </p></dd>

+<dt><span class="term">-R <em class="replaceable"><code>date/offset</code></em></span></dt>

+<dd><p>

+ Sets the date on which the key is to be revoked. After that

+ date, the key will be flagged as revoked. It will be included

+ in the zone and will be used to sign it.

+ </p></dd>

+<dt><span class="term">-I <em class="replaceable"><code>date/offset</code></em></span></dt>

+<dd><p>

+ Sets the date on which the key is to be retired. After that

+ date, the key will still be included in the zone, but it

+ will not be used to sign it.

+ </p></dd>

+<dt><span class="term">-D <em class="replaceable"><code>date/offset</code></em></span></dt>

+<dd><p>

+ Sets the date on which the key is to be deleted. After that

+ date, the key will no longer be included in the zone. (It

+ may remain in the key repository, however.)

+ </p></dd>

+<dt><span class="term">-i <em class="replaceable"><code>interval</code></em></span></dt>

+<dd>

+<p>

+ Sets the prepublication interval for a key. If set, then

+ the publication and activation dates must be separated by at least

+ this much time. If the activation date is specified but the

+ publication date isn't, then the publication date will default

+ to this much time before the activation date; conversely, if

+ the publication date is specified but activation date isn't,

+ then activation will be set to this much time after publication.

+ </p>

+<p>

+ If the key is being created as an explicit successor to another

+ key, then the default prepublication interval is 30 days;

+ otherwise it is zero.

+ </p>

+<p>

+ As with date offsets, if the argument is followed by one of

+ the suffixes 'y', 'mo', 'w', 'd', 'h', or 'mi', then the

+ interval is measured in years, months, weeks, days, hours,

+ or minutes, respectively. Without a suffix, the interval is

+ measured in seconds.

+ </p>

+</dd>

+</dl></div>

+</div>

+<div class="refsect1" lang="en">

+<a name="id2544491"></a><h2>GENERATED KEYS</h2>

+<a name="id2544642"></a><h2>EXAMPLE</h2>

+<a name="id2544685"></a><h2>SEE ALSO</h2>

+<a name="id2544716"></a><h2>AUTHOR</h2>

+.\" Copyright (C) 2009 Internet Systems Consortium, Inc. ("ISC")

+.\"

+.\" Permission to use, copy, modify, and/or distribute this software for any

+.\" purpose with or without fee is hereby granted, provided that the above

+.\" copyright notice and this permission notice appear in all copies.

+.\"

+.\" THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH

+.\" REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY

+.\" AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,

+.\" INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM

+.\" LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE

+.\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR

+.\" PERFORMANCE OF THIS SOFTWARE.

+.\"

+.\" $Id: dnssec-revoke.8,v 1.9 2010-05-19 01:14:14 tbox Exp $

+.\"

+.hy 0

+.ad l

+.\" Title: dnssec\-revoke

+.\" Author:

+.\" Generator: DocBook XSL Stylesheets v1.71.1 <http://docbook.sf.net/>

+.\" Date: June 1, 2009

+.\" Manual: BIND9

+.\" Source: BIND9

+.\"

+.TH "DNSSEC\-REVOKE" "8" "June 1, 2009" "BIND9" "BIND9"

+.\" disable hyphenation

+.nh

+.\" disable justification (adjust text to left margin only)

+.ad l

+.SH "NAME"

+dnssec\-revoke \- Set the REVOKED bit on a DNSSEC key

+.SH "SYNOPSIS"

+.HP 14

+\fBdnssec\-revoke\fR [\fB\-hr\fR] [\fB\-v\ \fR\fB\fIlevel\fR\fR] [\fB\-K\ \fR\fB\fIdirectory\fR\fR] [\fB\-E\ \fR\fB\fIengine\fR\fR] [\fB\-f\fR] {keyfile}

+.SH "DESCRIPTION"

+.PP

+\fBdnssec\-revoke\fR

+reads a DNSSEC key file, sets the REVOKED bit on the key as defined in RFC 5011, and creates a new pair of key files containing the now\-revoked key.

+.SH "OPTIONS"

+.PP

+\-h

+.RS 4

+Emit usage message and exit.

+.RE

+.PP

+\-K \fIdirectory\fR

+.RS 4

+Sets the directory in which the key files are to reside.

+.RE

+.PP

+\-r

+.RS 4

+After writing the new keyset files remove the original keyset files.

+.RE

+.PP

+\-v \fIlevel\fR

+.RS 4

+Sets the debugging level.

+.RE

+.PP

+\-E \fIengine\fR

+.RS 4

+Use the given OpenSSL engine. When compiled with PKCS#11 support it defaults to pkcs11; the empty name resets it to no engine.

+.RE

+.PP

+\-f

+.RS 4

+Force overwrite: Causes

+\fBdnssec\-revoke\fR

+to write the new key pair even if a file already exists matching the algorithm and key ID of the revoked key.

+.RE

+.SH "SEE ALSO"

+.PP

+\fBdnssec\-keygen\fR(8),

+BIND 9 Administrator Reference Manual,

+RFC 5011.

+.SH "AUTHOR"

+.PP

+Internet Systems Consortium

+.SH "COPYRIGHT"

+Copyright \(co 2009 Internet Systems Consortium, Inc. ("ISC")

+.br

+/*

+ * Copyright (C) 2009, 2010 Internet Systems Consortium, Inc. ("ISC")

+ *

+ * Permission to use, copy, modify, and/or distribute this software for any

+ * purpose with or without fee is hereby granted, provided that the above

+ * copyright notice and this permission notice appear in all copies.

+ *

+ * THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH

+ * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY

+ * AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,

+ * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM

+ * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE

+ * OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR

+ * PERFORMANCE OF THIS SOFTWARE.

+ */

+

+/* $Id: dnssec-revoke.c,v 1.22 2010-05-06 23:50:56 tbox Exp $ */

+

+/*! \file */

+

+#include <config.h>

+

+#include <libgen.h>

+#include <stdlib.h>

+#include <unistd.h>

+

+#include <isc/buffer.h>

+#include <isc/commandline.h>

+#include <isc/entropy.h>

+#include <isc/file.h>

+#include <isc/hash.h>

+#include <isc/mem.h>

+#include <isc/print.h>

+#include <isc/string.h>

+#include <isc/util.h>

+

+#include <dns/keyvalues.h>

+#include <dns/result.h>

+

+#include <dst/dst.h>

+

+#include "dnssectool.h"

+

+const char *program = "dnssec-revoke";

+int verbose;

+

+static isc_mem_t *mctx = NULL;

+

+ISC_PLATFORM_NORETURN_PRE static void

+usage(void) ISC_PLATFORM_NORETURN_POST;

+

+static void

+usage(void) {

+ fprintf(stderr, "Usage:\n");

+ fprintf(stderr, " %s [options] keyfile\n\n", program);

+ fprintf(stderr, "Version: %s\n", VERSION);

+#ifdef USE_PKCS11

+ fprintf(stderr, " -E engine: specify OpenSSL engine "

+ "(default \"pkcs11\")\n");

+#else

+ fprintf(stderr, " -E engine: specify OpenSSL engine\n");

+#endif

+ fprintf(stderr, " -f: force overwrite\n");

+ fprintf(stderr, " -K directory: use directory for key files\n");

+ fprintf(stderr, " -h: help\n");

+ fprintf(stderr, " -r: remove old keyfiles after "

+ "creating revoked version\n");

+ fprintf(stderr, " -v level: set level of verbosity\n");

+ fprintf(stderr, "Output:\n");

+ fprintf(stderr, " K<name>+<alg>+<new id>.key, "

+ "K<name>+<alg>+<new id>.private\n");

+

+ exit (-1);

+}

+

+int

+main(int argc, char **argv) {

+ isc_result_t result;

+#ifdef USE_PKCS11

+ const char *engine = "pkcs11";

+#else

+ const char *engine = NULL;

+#endif

+ char *filename = NULL, *dir = NULL;

+ char newname[1024], oldname[1024];

+ char keystr[DST_KEY_FORMATSIZE];

+ char *endp;

+ int ch;

+ isc_entropy_t *ectx = NULL;

+ dst_key_t *key = NULL;

+ isc_uint32_t flags;

+ isc_buffer_t buf;

+ isc_boolean_t force = ISC_FALSE;

+ isc_boolean_t remove = ISC_FALSE;

+

+ if (argc == 1)

+ usage();

+

+ result = isc_mem_create(0, 0, &mctx);

+ if (result != ISC_R_SUCCESS)

+ fatal("Out of memory");

+

+ dns_result_register();

+

+ isc_commandline_errprint = ISC_FALSE;

+

+ while ((ch = isc_commandline_parse(argc, argv, "E:fK:rhv:")) != -1) {

+ switch (ch) {

+ case 'E':

+ engine = isc_commandline_argument;

+ break;

+ case 'f':

+ force = ISC_TRUE;

+ break;

+ case 'K':

+ /*

+ * We don't have to copy it here, but do it to

+ * simplify cleanup later

+ */

+ dir = isc_mem_strdup(mctx, isc_commandline_argument);

+ if (dir == NULL) {

+ fatal("Failed to allocate memory for "

+ "directory");

+ }

+ break;

+ case 'r':

+ remove = ISC_TRUE;

+ break;

+ case 'v':

+ verbose = strtol(isc_commandline_argument, &endp, 0);

+ if (*endp != '\0')

+ fatal("-v must be followed by a number");

+ break;

+ case '?':

+ if (isc_commandline_option != '?')

+ fprintf(stderr, "%s: invalid argument -%c\n",

+ program, isc_commandline_option);

+ /* Falls into */

+ case 'h':

+ usage();

+

+ default:

+ fprintf(stderr, "%s: unhandled option -%c\n",

+ program, isc_commandline_option);

+ exit(1);

+ }

+ }

+

+ if (argc < isc_commandline_index + 1 ||

+ argv[isc_commandline_index] == NULL)

+ fatal("The key file name was not specified");

+ if (argc > isc_commandline_index + 1)

+ fatal("Extraneous arguments");

+

+ if (dir != NULL) {

+ filename = argv[isc_commandline_index];

+ } else {

+ result = isc_file_splitpath(mctx, argv[isc_commandline_index],

+ &dir, &filename);

+ if (result != ISC_R_SUCCESS)

+ fatal("cannot process filename %s: %s",

+ argv[isc_commandline_index],

+ isc_result_totext(result));

+ if (strcmp(dir, ".") == 0) {

+ isc_mem_free(mctx, dir);

+ dir = NULL;

+ }

+ }

+

+ if (ectx == NULL)

+ setup_entropy(mctx, NULL, &ectx);

+ result = isc_hash_create(mctx, ectx, DNS_NAME_MAXWIRE);

+ if (result != ISC_R_SUCCESS)

+ fatal("Could not initialize hash");

+ result = dst_lib_init2(mctx, ectx, engine,

+ ISC_ENTROPY_BLOCKING | ISC_ENTROPY_GOODONLY);

+ if (result != ISC_R_SUCCESS)

+ fatal("Could not initialize dst: %s",

+ isc_result_totext(result));

+ isc_entropy_stopcallbacksources(ectx);

+

+ result = dst_key_fromnamedfile(filename, dir,

+ DST_TYPE_PUBLIC|DST_TYPE_PRIVATE,

+ mctx, &key);

+ if (result != ISC_R_SUCCESS)

+ fatal("Invalid keyfile name %s: %s",

+ filename, isc_result_totext(result));

+

+ dst_key_format(key, keystr, sizeof(keystr));

+

+ if (verbose > 2)

+ fprintf(stderr, "%s: %s\n", program, keystr);

+

+ if (force)

+ set_keyversion(key);

+ else

+ check_keyversion(key, keystr);

+

+

+ flags = dst_key_flags(key);

+ if ((flags & DNS_KEYFLAG_REVOKE) == 0) {

+ isc_stdtime_t now;

+

+ if ((flags & DNS_KEYFLAG_KSK) == 0)

+ fprintf(stderr, "%s: warning: Key is not flagged "

+ "as a KSK. Revoking a ZSK is "

+ "legal, but undefined.\n",

+ program);

+

+ isc_stdtime_get(&now);

+ dst_key_settime(key, DST_TIME_REVOKE, now);

+

+ dst_key_setflags(key, flags | DNS_KEYFLAG_REVOKE);

+

+ isc_buffer_init(&buf, newname, sizeof(newname));

+ dst_key_buildfilename(key, DST_TYPE_PUBLIC, dir, &buf);

+

+ if (access(newname, F_OK) == 0 && !force) {

+ fatal("Key file %s already exists; "

+ "use -f to force overwrite", newname);

+ }

+

+ result = dst_key_tofile(key, DST_TYPE_PUBLIC|DST_TYPE_PRIVATE,

+ dir);

+ if (result != ISC_R_SUCCESS) {

+ dst_key_format(key, keystr, sizeof(keystr));

+ fatal("Failed to write key %s: %s", keystr,

+ isc_result_totext(result));

+ }

+

+ isc_buffer_clear(&buf);

+ dst_key_buildfilename(key, 0, dir, &buf);

+ printf("%s\n", newname);

+

+ /*

+ * Remove old key file, if told to (and if

+ * it isn't the same as the new file)

+ */

+ if (remove && dst_key_alg(key) != DST_ALG_RSAMD5) {

+ isc_buffer_init(&buf, oldname, sizeof(oldname));

+ dst_key_setflags(key, flags & ~DNS_KEYFLAG_REVOKE);

+ dst_key_buildfilename(key, DST_TYPE_PRIVATE, dir, &buf);

+ if (strcmp(oldname, newname) == 0)

+ goto cleanup;

+ if (access(oldname, F_OK) == 0)

+ unlink(oldname);

+ isc_buffer_clear(&buf);

+ dst_key_buildfilename(key, DST_TYPE_PUBLIC, dir, &buf);

+ if (access(oldname, F_OK) == 0)

+ unlink(oldname);

+ }

+ } else {

+ dst_key_format(key, keystr, sizeof(keystr));

+ fatal("Key %s is already revoked", keystr);

+ }

+

+cleanup:

+ dst_key_free(&key);

+ dst_lib_destroy();

+ isc_hash_destroy();

+ cleanup_entropy(&ectx);

+ if (verbose > 10)

+ isc_mem_stats(mctx, stdout);

+ if (dir != NULL)

+ isc_mem_free(mctx, dir);

+ isc_mem_destroy(&mctx);

+

+ return (0);

+}

+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"

+ "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"

+ [<!ENTITY mdash "&#8212;">]>

+<!--

+ - Copyright (C) 2009 Internet Systems Consortium, Inc. ("ISC")

+ -

+ - Permission to use, copy, modify, and/or distribute this software for any

+ - purpose with or without fee is hereby granted, provided that the above

+ - copyright notice and this permission notice appear in all copies.

+ -

+ - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH

+ - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY

+ - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,

+ - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM

+ - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE

+ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR

+ - PERFORMANCE OF THIS SOFTWARE.

+-->

+

+<!-- $Id: dnssec-revoke.docbook,v 1.7 2009-11-03 21:44:46 each Exp $ -->

+<refentry id="man.dnssec-revoke">

+ <refentryinfo>

+ <date>June 1, 2009</date>

+ </refentryinfo>

+

+ <refmeta>

+ <refentrytitle><application>dnssec-revoke</application></refentrytitle>

+ <manvolnum>8</manvolnum>

+ <refmiscinfo>BIND9</refmiscinfo>

+ </refmeta>

+

+ <refnamediv>

+ <refname><application>dnssec-revoke</application></refname>

+ <refpurpose>Set the REVOKED bit on a DNSSEC key</refpurpose>

+ </refnamediv>

+

+ <docinfo>

+ <copyright>

+ <year>2009</year>

+ <holder>Internet Systems Consortium, Inc. ("ISC")</holder>

+ </copyright>

+ </docinfo>

+

+ <refsynopsisdiv>

+ <cmdsynopsis>

+ <command>dnssec-revoke</command>

+ <arg><option>-hr</option></arg>

+ <arg><option>-v <replaceable class="parameter">level</replaceable></option></arg>

+ <arg><option>-K <replaceable class="parameter">directory</replaceable></option></arg>

+ <arg><option>-E <replaceable class="parameter">engine</replaceable></option></arg>

+ <arg><option>-f</option></arg>

+ <arg choice="req">keyfile</arg>

+ </cmdsynopsis>

+ </refsynopsisdiv>

+

+ <refsect1>

+ <title>DESCRIPTION</title>

+ <para><command>dnssec-revoke</command>

+ reads a DNSSEC key file, sets the REVOKED bit on the key as defined

+ in RFC 5011, and creates a new pair of key files containing the

+ now-revoked key.

+ </para>

+ </refsect1>

+

+ <refsect1>

+ <title>OPTIONS</title>

+

+ <variablelist>

+ <varlistentry>

+ <term>-h</term>

+ <listitem>

+ <para>

+ Emit usage message and exit.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-K <replaceable class="parameter">directory</replaceable></term>

+ <listitem>

+ <para>

+ Sets the directory in which the key files are to reside.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <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>-E <replaceable class="parameter">engine</replaceable></term>

+ <listitem>

+ <para>

+ Use the given OpenSSL engine. When compiled with PKCS#11 support

+ it defaults to pkcs11; the empty name resets it to no engine.

+ </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>

+ </variablelist>

+ </refsect1>

+

+ <refsect1>

+ <title>SEE ALSO</title>

+ <para><citerefentry>

+ <refentrytitle>dnssec-keygen</refentrytitle><manvolnum>8</manvolnum>

+ </citerefentry>,

+ <citetitle>BIND 9 Administrator Reference Manual</citetitle>,

+ <citetitle>RFC 5011</citetitle>.

+ </para>

+ </refsect1>

+

+ <refsect1>

+ <title>AUTHOR</title>

+ <para><corpauthor>Internet Systems Consortium</corpauthor>

+ </para>

+ </refsect1>

+

+</refentry><!--

+ - Local variables:

+ - mode: sgml

+ - End:

+-->

+<!--

+ - Copyright (C) 2009 Internet Systems Consortium, Inc. ("ISC")

+ -

+ - Permission to use, copy, modify, and/or distribute this software for any

+ - purpose with or without fee is hereby granted, provided that the above

+ - copyright notice and this permission notice appear in all copies.

+ -

+ - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH

+ - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY

+ - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,

+ - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM

+ - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE

+ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR

+ - PERFORMANCE OF THIS SOFTWARE.

+-->

+<!-- $Id: dnssec-revoke.html,v 1.9 2010-05-19 01:14:14 tbox Exp $ -->

+<html>

+<head>

+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">

+<title>dnssec-revoke</title>

+<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">

+</head>

+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en">

+<a name="man.dnssec-revoke"></a><div class="titlepage"></div>

+<div class="refnamediv">

+<h2>Name</h2>

+<p><span class="application">dnssec-revoke</span> &#8212; Set the REVOKED bit on a DNSSEC key</p>

+</div>

+<div class="refsynopsisdiv">

+<h2>Synopsis</h2>

+<div class="cmdsynopsis"><p><code class="command">dnssec-revoke</code> [<code class="option">-hr</code>] [<code class="option">-v <em class="replaceable"><code>level</code></em></code>] [<code class="option">-K <em class="replaceable"><code>directory</code></em></code>] [<code class="option">-E <em class="replaceable"><code>engine</code></em></code>] [<code class="option">-f</code>] {keyfile}</p></div>

+</div>

+<div class="refsect1" lang="en">

+<a name="id2543373"></a><h2>DESCRIPTION</h2>

+<p><span><strong class="command">dnssec-revoke</strong></span>

+ reads a DNSSEC key file, sets the REVOKED bit on the key as defined

+ in RFC 5011, and creates a new pair of key files containing the

+ now-revoked key.

+ </p>

+</div>

+<div class="refsect1" lang="en">

+<a name="id2543385"></a><h2>OPTIONS</h2>

+<div class="variablelist"><dl>

+<dt><span class="term">-h</span></dt>

+<dd><p>

+ Emit usage message and exit.

+ </p></dd>

+<dt><span class="term">-K <em class="replaceable"><code>directory</code></em></span></dt>

+<dd><p>

+ Sets the directory in which the key files are to reside.

+ </p></dd>

+<dt><span class="term">-r</span></dt>

+<dd><p>

+ After writing the new keyset files remove the original keyset

+ files.

+ </p></dd>

+<dt><span class="term">-v <em class="replaceable"><code>level</code></em></span></dt>

+<dd><p>

+ Sets the debugging level.

+ </p></dd>

+<dt><span class="term">-E <em class="replaceable"><code>engine</code></em></span></dt>

+<dd><p>

+ Use the given OpenSSL engine. When compiled with PKCS#11 support

+ it defaults to pkcs11; the empty name resets it to no engine.

+ </p></dd>

+<dt><span class="term">-f</span></dt>

+<dd><p>

+ Force overwrite: Causes <span><strong class="command">dnssec-revoke</strong></span> to

+ write the new key pair even if a file already exists matching

+ the algorithm and key ID of the revoked key.

+ </p></dd>

+</dl></div>

+</div>

+<div class="refsect1" lang="en">

+<a name="id2543491"></a><h2>SEE ALSO</h2>

+<p><span class="citerefentry"><span class="refentrytitle">dnssec-keygen</span>(8)</span>,

+ <em class="citetitle">BIND 9 Administrator Reference Manual</em>,

+ <em class="citetitle">RFC 5011</em>.

+ </p>

+</div>

+<div class="refsect1" lang="en">

+<a name="id2543515"></a><h2>AUTHOR</h2>

+<p><span class="corpauthor">Internet Systems Consortium</span>

+ </p>

+</div>

+</div></body>

+</html>

+.\" Copyright (C) 2009, 2010 Internet Systems Consortium, Inc. ("ISC")

+.\"

+.\" Permission to use, copy, modify, and/or distribute this software for any

+.\" purpose with or without fee is hereby granted, provided that the above

+.\" copyright notice and this permission notice appear in all copies.

+.\"

+.\" THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH

+.\" REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY

+.\" AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,

+.\" INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM

+.\" LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE

+.\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR

+.\" PERFORMANCE OF THIS SOFTWARE.

+.\"

+.\" $Id: dnssec-settime.8,v 1.14 2010-08-17 01:15:26 tbox Exp $

+.\"

+.hy 0

+.ad l

+.\" Title: dnssec\-settime

+.\" Author:

+.\" Generator: DocBook XSL Stylesheets v1.71.1 <http://docbook.sf.net/>

+.\" Date: July 15, 2009

+.\" Manual: BIND9

+.\" Source: BIND9

+.\"

+.TH "DNSSEC\-SETTIME" "8" "July 15, 2009" "BIND9" "BIND9"

+.\" disable hyphenation

+.nh

+.\" disable justification (adjust text to left margin only)

+.ad l

+.SH "NAME"

+dnssec\-settime \- Set the key timing metadata for a DNSSEC key

+.SH "SYNOPSIS"

+.HP 15

+\fBdnssec\-settime\fR [\fB\-f\fR] [\fB\-K\ \fR\fB\fIdirectory\fR\fR] [\fB\-P\ \fR\fB\fIdate/offset\fR\fR] [\fB\-A\ \fR\fB\fIdate/offset\fR\fR] [\fB\-R\ \fR\fB\fIdate/offset\fR\fR] [\fB\-I\ \fR\fB\fIdate/offset\fR\fR] [\fB\-D\ \fR\fB\fIdate/offset\fR\fR] [\fB\-h\fR] [\fB\-v\ \fR\fB\fIlevel\fR\fR] [\fB\-E\ \fR\fB\fIengine\fR\fR] {keyfile}

+.SH "DESCRIPTION"

+.PP

+\fBdnssec\-settime\fR

+reads a DNSSEC private key file and sets the key timing metadata as specified by the

+\fB\-P\fR,

+\fB\-A\fR,

+\fB\-R\fR,

+\fB\-I\fR, and

+\fB\-D\fR

+options. The metadata can then be used by

+\fBdnssec\-signzone\fR

+or other signing software to determine when a key is to be published, whether it should be used for signing a zone, etc.

+.PP

+If none of these options is set on the command line, then

+\fBdnssec\-settime\fR

+simply prints the key timing metadata already stored in the key.

+.PP

+When key metadata fields are changed, both files of a key pair (\fIKnnnn.+aaa+iiiii.key\fR

+and

+\fIKnnnn.+aaa+iiiii.private\fR) are regenerated. Metadata fields are stored in the private file. A human\-readable description of the metadata is also placed in comments in the key file.

+.SH "OPTIONS"

+.PP

+\-f

+.RS 4

+Force an update of an old\-format key with no metadata fields. Without this option,

+\fBdnssec\-settime\fR

+will fail when attempting to update a legacy key. With this option, the key will be recreated in the new format, but with the original key data retained. The key's creation date will be set to the present time.

+.RE

+.PP

+\-K \fIdirectory\fR

+.RS 4

+Sets the directory in which the key files are to reside.

+.RE

+.PP

+\-h

+.RS 4

+Emit usage message and exit.

+.RE

+.PP

+\-v \fIlevel\fR

+.RS 4

+Sets the debugging level.

+.RE

+.PP

+\-E \fIengine\fR

+.RS 4

+Use the given OpenSSL engine. When compiled with PKCS#11 support it defaults to pkcs11; the empty name resets it to no engine.

+.RE

+.SH "TIMING OPTIONS"

+.PP

+Dates can be expressed in the format YYYYMMDD or YYYYMMDDHHMMSS. If the argument begins with a '+' or '\-', it is interpreted as an offset from the present time. For convenience, if such an offset is followed by one of the suffixes 'y', 'mo', 'w', 'd', 'h', or 'mi', then the offset is computed in years (defined as 365 24\-hour days, ignoring leap years), months (defined as 30 24\-hour days), weeks, days, hours, or minutes, respectively. Without a suffix, the offset is computed in seconds. To unset a date, use 'none'.

+.PP

+\-P \fIdate/offset\fR

+.RS 4

+Sets the date on which a key is to be published to the zone. After that date, the key will be included in the zone but will not be used to sign it.

+.RE

+.PP

+\-A \fIdate/offset\fR

+.RS 4

+Sets the date on which the key is to be activated. After that date, the key will be included in the zone and used to sign it.

+.RE

+.PP

+\-R \fIdate/offset\fR

+.RS 4

+Sets the date on which the key is to be revoked. After that date, the key will be flagged as revoked. It will be included in the zone and will be used to sign it.

+.RE

+.PP

+\-I \fIdate/offset\fR

+.RS 4

+Sets the date on which the key is to be retired. After that date, the key will still be included in the zone, but it will not be used to sign it.

+.RE

+.PP

+\-D \fIdate/offset\fR

+.RS 4

+Sets the date on which the key is to be deleted. After that date, the key will no longer be included in the zone. (It may remain in the key repository, however.)

+.RE

+.PP

+\-S \fIpredecessor key\fR

+.RS 4

+Select a key for which the key being modified will be an explicit successor. The name, algorithm, size, and type of the predecessor key must exactly match those of the key being modified. The activation date of the successor key will be set to the inactivation date of the predecessor. The publication date will be set to the activation date minus the prepublication interval, which defaults to 30 days.

+.RE

+.PP

+\-i \fIinterval\fR

+.RS 4

+Sets the prepublication interval for a key. If set, then the publication and activation dates must be separated by at least this much time. If the activation date is specified but the publication date isn't, then the publication date will default to this much time before the activation date; conversely, if the publication date is specified but activation date isn't, then activation will be set to this much time after publication.

+.sp

+If the key is being set to be an explicit successor to another key, then the default prepublication interval is 30 days; otherwise it is zero.

+.sp

+As with date offsets, if the argument is followed by one of the suffixes 'y', 'mo', 'w', 'd', 'h', or 'mi', then the interval is measured in years, months, weeks, days, hours, or minutes, respectively. Without a suffix, the interval is measured in seconds.

+.RE

+.SH "PRINTING OPTIONS"

+.PP

+\fBdnssec\-settime\fR

+can also be used to print the timing metadata associated with a key.

+.PP

+\-u

+.RS 4

+Print times in UNIX epoch format.

+.RE

+.PP

+\-p \fIC/P/A/R/I/D/all\fR

+.RS 4

+Print a specific metadata value or set of metadata values. The

+\fB\-p\fR

+option may be followed by one or more of the following letters to indicate which value or values to print:

+\fBC\fR

+for the creation date,

+\fBP\fR

+for the publication date,

+\fBA\fR

+for the activation date,

+\fBR\fR

+for the revocation date,

+\fBI\fR

+for the inactivation date, or

+\fBD\fR

+for the deletion date. To print all of the metadata, use

+\fB\-p all\fR.

+.RE

+.SH "SEE ALSO"

+.PP

+\fBdnssec\-keygen\fR(8),

+\fBdnssec\-signzone\fR(8),

+BIND 9 Administrator Reference Manual,

+RFC 5011.

+.SH "AUTHOR"

+.PP

+Internet Systems Consortium

+.SH "COPYRIGHT"

+Copyright \(co 2009, 2010 Internet Systems Consortium, Inc. ("ISC")

+.br

+/*

+ * Copyright (C) 2009, 2010 Internet Systems Consortium, Inc. ("ISC")

+ *

+ * Permission to use, copy, modify, and/or distribute this software for any

+ * purpose with or without fee is hereby granted, provided that the above

+ * copyright notice and this permission notice appear in all copies.

+ *

+ * THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH

+ * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY

+ * AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,

+ * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM

+ * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE

+ * OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR

+ * PERFORMANCE OF THIS SOFTWARE.

+ */

+

+/* $Id: dnssec-settime.c,v 1.28 2010-12-19 07:29:36 each Exp $ */

+

+/*! \file */

+

+#include <config.h>

+

+#include <libgen.h>

+#include <stdlib.h>

+#include <unistd.h>

+#include <errno.h>

+#include <time.h>

+

+#include <isc/buffer.h>

+#include <isc/commandline.h>

+#include <isc/entropy.h>

+#include <isc/file.h>

+#include <isc/hash.h>

+#include <isc/mem.h>

+#include <isc/print.h>

+#include <isc/string.h>

+#include <isc/util.h>

+

+#include <dns/keyvalues.h>

+#include <dns/result.h>

+

+#include <dst/dst.h>

+

+#include "dnssectool.h"

+

+const char *program = "dnssec-settime";

+int verbose;

+

+static isc_mem_t *mctx = NULL;

+

+ISC_PLATFORM_NORETURN_PRE static void

+usage(void) ISC_PLATFORM_NORETURN_POST;

+

+static void

+usage(void) {

+ fprintf(stderr, "Usage:\n");

+ fprintf(stderr, " %s [options] keyfile\n\n", program);

+ fprintf(stderr, "Version: %s\n", VERSION);

+ fprintf(stderr, "General options:\n");

+#ifdef USE_PKCS11

+ fprintf(stderr, " -E engine: specify OpenSSL engine "

+ "(default \"pkcs11\")\n");

+#else

+ fprintf(stderr, " -E engine: specify OpenSSL engine\n");

+#endif

+ fprintf(stderr, " -f: force update of old-style "

+ "keys\n");

+ fprintf(stderr, " -K directory: set key file location\n");

+ fprintf(stderr, " -v level: set level of verbosity\n");

+ fprintf(stderr, " -h: help\n");

+ fprintf(stderr, "Timing options:\n");

+ fprintf(stderr, " -P date/[+-]offset/none: set/unset key "

+ "publication date\n");

+ fprintf(stderr, " -A date/[+-]offset/none: set/unset key "

+ "activation date\n");

+ fprintf(stderr, " -R date/[+-]offset/none: set/unset key "

+ "revocation date\n");

+ fprintf(stderr, " -I date/[+-]offset/none: set/unset key "

+ "inactivation date\n");

+ fprintf(stderr, " -D date/[+-]offset/none: set/unset key "

+ "deletion date\n");

+ fprintf(stderr, "Printing options:\n");

+ fprintf(stderr, " -p C/P/A/R/I/D/all: print a particular time "

+ "value or values "

+ "[default: all]\n");

+ fprintf(stderr, " -u: print times in unix epoch "

+ "format\n");

+ fprintf(stderr, "Output:\n");

+ fprintf(stderr, " K<name>+<alg>+<new id>.key, "

+ "K<name>+<alg>+<new id>.private\n");

+

+ exit (-1);

+}

+

+static void

+printtime(dst_key_t *key, int type, const char *tag, isc_boolean_t epoch,

+ FILE *stream)

+{

+ isc_result_t result;

+ const char *output = NULL;

+ isc_stdtime_t when;

+

+ if (tag != NULL)

+ fprintf(stream, "%s: ", tag);

+

+ result = dst_key_gettime(key, type, &when);

+ if (result == ISC_R_NOTFOUND) {

+ fprintf(stream, "UNSET\n");

+ } else if (epoch) {

+ fprintf(stream, "%d\n", (int) when);

+ } else {

+ time_t time = when;

+ output = ctime(&time);

+ fprintf(stream, "%s", output);

+ }

+}

+

+int

+main(int argc, char **argv) {

+ isc_result_t result;

+#ifdef USE_PKCS11

+ const char *engine = "pkcs11";

+#else

+ const char *engine = NULL;

+#endif

+ char *filename = NULL, *directory = NULL;

+ char newname[1024];

+ char keystr[DST_KEY_FORMATSIZE];

+ char *endp, *p;

+ int ch;

+ isc_entropy_t *ectx = NULL;

+ const char *predecessor = NULL;

+ dst_key_t *prevkey = NULL;

+ dst_key_t *key = NULL;

+ isc_buffer_t buf;

+ dns_name_t *name = NULL;

+ dns_secalg_t alg = 0;

+ unsigned int size = 0;

+ isc_uint16_t flags = 0;

+ int prepub = -1;

+ isc_stdtime_t now;

+ isc_stdtime_t pub = 0, act = 0, rev = 0, inact = 0, del = 0;

+ isc_boolean_t setpub = ISC_FALSE, setact = ISC_FALSE;

+ isc_boolean_t setrev = ISC_FALSE, setinact = ISC_FALSE;

+ isc_boolean_t setdel = ISC_FALSE;

+ isc_boolean_t unsetpub = ISC_FALSE, unsetact = ISC_FALSE;

+ isc_boolean_t unsetrev = ISC_FALSE, unsetinact = ISC_FALSE;

+ isc_boolean_t unsetdel = ISC_FALSE;

+ isc_boolean_t printcreate = ISC_FALSE, printpub = ISC_FALSE;

+ isc_boolean_t printact = ISC_FALSE, printrev = ISC_FALSE;

+ isc_boolean_t printinact = ISC_FALSE, printdel = ISC_FALSE;

+ isc_boolean_t force = ISC_FALSE;

+ isc_boolean_t epoch = ISC_FALSE;

+ isc_boolean_t changed = ISC_FALSE;

+

+ if (argc == 1)

+ usage();

+

+ result = isc_mem_create(0, 0, &mctx);

+ if (result != ISC_R_SUCCESS)

+ fatal("Out of memory");

+

+ dns_result_register();

+

+ isc_commandline_errprint = ISC_FALSE;

+

+ isc_stdtime_get(&now);

+

+#define CMDLINE_FLAGS "A:D:E:fhI:i:K:P:p:R:S:uv:"

+ while ((ch = isc_commandline_parse(argc, argv, CMDLINE_FLAGS)) != -1) {

+ switch (ch) {

+ case 'E':

+ engine = isc_commandline_argument;

+ break;

+ case 'f':

+ force = ISC_TRUE;

+ break;

+ case 'p':

+ p = isc_commandline_argument;

+ if (!strcasecmp(p, "all")) {

+ printcreate = ISC_TRUE;

+ printpub = ISC_TRUE;

+ printact = ISC_TRUE;

+ printrev = ISC_TRUE;

+ printinact = ISC_TRUE;

+ printdel = ISC_TRUE;

+ break;

+ }

+

+ do {

+ switch (*p++) {

+ case 'C':

+ printcreate = ISC_TRUE;

+ break;

+ case 'P':

+ printpub = ISC_TRUE;

+ break;

+ case 'A':

+ printact = ISC_TRUE;

+ break;

+ case 'R':

+ printrev = ISC_TRUE;

+ break;

+ case 'I':

+ printinact = ISC_TRUE;

+ break;

+ case 'D':

+ printdel = ISC_TRUE;

+ break;

+ case ' ':

+ break;

+ default:

+ usage();

+ break;

+ }

+ } while (*p != '\0');

+ break;

+ case 'u':

+ epoch = ISC_TRUE;

+ break;

+ case 'K':

+ /*

+ * We don't have to copy it here, but do it to

+ * simplify cleanup later

+ */

+ directory = isc_mem_strdup(mctx,

+ isc_commandline_argument);

+ if (directory == NULL) {

+ fatal("Failed to allocate memory for "

+ "directory");

+ }

+ break;

+ case 'v':

+ verbose = strtol(isc_commandline_argument, &endp, 0);

+ if (*endp != '\0')

+ fatal("-v must be followed by a number");

+ break;

+ case 'P':

+ if (setpub || unsetpub)

+ fatal("-P specified more than once");

+

+ changed = ISC_TRUE;

+ if (!strcasecmp(isc_commandline_argument, "none")) {

+ unsetpub = ISC_TRUE;

+ } else {

+ setpub = ISC_TRUE;

+ pub = strtotime(isc_commandline_argument,

+ now, now);

+ }

+ break;

+ case 'A':

+ if (setact || unsetact)

+ fatal("-A specified more than once");

+

+ changed = ISC_TRUE;

+ if (!strcasecmp(isc_commandline_argument, "none")) {

+ unsetact = ISC_TRUE;

+ } else {

+ setact = ISC_TRUE;

+ act = strtotime(isc_commandline_argument,

+ now, now);

+ }

+ break;

+ case 'R':

+ if (setrev || unsetrev)

+ fatal("-R specified more than once");

+

+ changed = ISC_TRUE;

+ if (!strcasecmp(isc_commandline_argument, "none")) {

+ unsetrev = ISC_TRUE;

+ } else {

+ setrev = ISC_TRUE;

+ rev = strtotime(isc_commandline_argument,

+ now, now);

+ }

+ break;

+ case 'I':

+ if (setinact || unsetinact)

+ fatal("-I specified more than once");

+

+ changed = ISC_TRUE;

+ if (!strcasecmp(isc_commandline_argument, "none")) {

+ unsetinact = ISC_TRUE;

+ } else {

+ setinact = ISC_TRUE;

+ inact = strtotime(isc_commandline_argument,

+ now, now);

+ }

+ break;

+ case 'D':

+ if (setdel || unsetdel)

+ fatal("-D specified more than once");

+

+ changed = ISC_TRUE;

+ if (!strcasecmp(isc_commandline_argument, "none")) {

+ unsetdel = ISC_TRUE;

+ } else {

+ setdel = ISC_TRUE;

+ del = strtotime(isc_commandline_argument,

+ now, now);

+ }

+ break;

+ case 'S':

+ predecessor = isc_commandline_argument;

+ break;

+ case 'i':

+ prepub = strtottl(isc_commandline_argument);

+ break;

+ case '?':

+ if (isc_commandline_option != '?')

+ fprintf(stderr, "%s: invalid argument -%c\n",

+ program, isc_commandline_option);

+ /* Falls into */

+ case 'h':

+ usage();

+

+ default:

+ fprintf(stderr, "%s: unhandled option -%c\n",

+ program, isc_commandline_option);

+ exit(1);

+ }

+ }

+

+ if (argc < isc_commandline_index + 1 ||

+ argv[isc_commandline_index] == NULL)

+ fatal("The key file name was not specified");

+ if (argc > isc_commandline_index + 1)

+ fatal("Extraneous arguments");

+

+ if (ectx == NULL)

+ setup_entropy(mctx, NULL, &ectx);

+ result = isc_hash_create(mctx, ectx, DNS_NAME_MAXWIRE);

+ if (result != ISC_R_SUCCESS)

+ fatal("Could not initialize hash");

+ result = dst_lib_init2(mctx, ectx, engine,

+ ISC_ENTROPY_BLOCKING | ISC_ENTROPY_GOODONLY);

+ if (result != ISC_R_SUCCESS)

+ fatal("Could not initialize dst: %s",

+ isc_result_totext(result));

+ isc_entropy_stopcallbacksources(ectx);

+

+ if (predecessor != NULL) {

+ char keystr[DST_KEY_FORMATSIZE];

+ isc_stdtime_t when;

+ int major, minor;

+

+ if (prepub == -1)

+ prepub = (30 * 86400);

+

+ if (setpub || unsetpub)

+ fatal("-S and -P cannot be used together");

+ if (setact || unsetact)

+ fatal("-S and -A cannot be used together");

+

+ result = dst_key_fromnamedfile(predecessor, directory,

+ DST_TYPE_PUBLIC |

+ DST_TYPE_PRIVATE,

+ mctx, &prevkey);

+ if (result != ISC_R_SUCCESS)

+ fatal("Invalid keyfile %s: %s",

+ filename, isc_result_totext(result));

+ if (!dst_key_isprivate(prevkey))

+ fatal("%s is not a private key", filename);

+

+ name = dst_key_name(prevkey);

+ alg = dst_key_alg(prevkey);

+ size = dst_key_size(prevkey);

+ flags = dst_key_flags(prevkey);

+

+ dst_key_format(prevkey, keystr, sizeof(keystr));

+ dst_key_getprivateformat(prevkey, &major, &minor);

+ if (major != DST_MAJOR_VERSION || minor < DST_MINOR_VERSION)

+ fatal("Predecessor has incompatible format "

+ "version %d.%d\n\t", major, minor);

+

+ result = dst_key_gettime(prevkey, DST_TIME_ACTIVATE, &when);

+ if (result != ISC_R_SUCCESS)

+ fatal("Predecessor has no activation date. "

+ "You must set one before\n\t"

+ "generating a successor.");

+

+ result = dst_key_gettime(prevkey, DST_TIME_INACTIVE, &act);

+ if (result != ISC_R_SUCCESS)

+ fatal("Predecessor has no inactivation date. "

+ "You must set one before\n\t"

+ "generating a successor.");

+

+ pub = act - prepub;

+ if (pub < now && prepub != 0)

+ fatal("Predecessor will become inactive before the\n\t"

+ "prepublication period ends. Either change "

+ "its inactivation date,\n\t"

+ "or use the -i option to set a shorter "

+ "prepublication interval.");

+

+ result = dst_key_gettime(prevkey, DST_TIME_DELETE, &when);

+ if (result != ISC_R_SUCCESS)

+ fprintf(stderr, "%s: WARNING: Predecessor has no "

+ "removal date;\n\t"

+ "it will remain in the zone "

+ "indefinitely after rollover.\n",

+ program);

+

+ changed = setpub = setact = ISC_TRUE;

+ dst_key_free(&prevkey);

+ } else {

+ if (prepub < 0)

+ prepub = 0;

+

+ if (prepub > 0) {

+ if (setpub && setact && (act - prepub) < pub)

+ fatal("Activation and publication dates "

+ "are closer together than the\n\t"

+ "prepublication interval.");

+

+ if (setpub && !setact) {

+ setact = ISC_TRUE;

+ act = pub + prepub;

+ } else if (setact && !setpub) {

+ setpub = ISC_TRUE;

+ pub = act - prepub;

+ }

+

+ if ((act - prepub) < now)

+ fatal("Time until activation is shorter "

+ "than the\n\tprepublication interval.");

+ }

+ }

+

+ if (directory != NULL) {

+ filename = argv[isc_commandline_index];

+ } else {

+ result = isc_file_splitpath(mctx, argv[isc_commandline_index],

+ &directory, &filename);

+ if (result != ISC_R_SUCCESS)

+ fatal("cannot process filename %s: %s",

+ argv[isc_commandline_index],

+ isc_result_totext(result));

+ }

+

+ result = dst_key_fromnamedfile(filename, directory,

+ DST_TYPE_PUBLIC | DST_TYPE_PRIVATE,

+ mctx, &key);

+ if (result != ISC_R_SUCCESS)

+ fatal("Invalid keyfile %s: %s",

+ filename, isc_result_totext(result));

+

+ if (!dst_key_isprivate(key))

+ fatal("%s is not a private key", filename);

+

+ dst_key_format(key, keystr, sizeof(keystr));

+

+ if (predecessor != NULL) {

+ if (!dns_name_equal(name, dst_key_name(key)))

+ fatal("Key name mismatch");

+ if (alg != dst_key_alg(key))

+ fatal("Key algorithm mismatch");

+ if (size != dst_key_size(key))

+ fatal("Key size mismatch");

+ if (flags != dst_key_flags(key))

+ fatal("Key flags mismatch");

+ }

+

+ if (force)

+ set_keyversion(key);

+ else

+ check_keyversion(key, keystr);

+

+ if (verbose > 2)

+ fprintf(stderr, "%s: %s\n", program, keystr);

+

+ /*

+ * Set time values.

+ */

+ if (setpub)

+ dst_key_settime(key, DST_TIME_PUBLISH, pub);

+ else if (unsetpub)

+ dst_key_unsettime(key, DST_TIME_PUBLISH);

+

+ if (setact)

+ dst_key_settime(key, DST_TIME_ACTIVATE, act);

+ else if (unsetact)

+ dst_key_unsettime(key, DST_TIME_ACTIVATE);

+

+ if (setrev) {

+ if ((dst_key_flags(key) & DNS_KEYFLAG_REVOKE) != 0)

+ fprintf(stderr, "%s: warning: Key %s is already "

+ "revoked; changing the revocation date "

+ "will not affect this.\n",

+ program, keystr);

+ if ((dst_key_flags(key) & DNS_KEYFLAG_KSK) == 0)

+ fprintf(stderr, "%s: warning: Key %s is not flagged as "

+ "a KSK, but -R was used. Revoking a "

+ "ZSK is legal, but undefined.\n",

+ program, keystr);

+ dst_key_settime(key, DST_TIME_REVOKE, rev);

+ } else if (unsetrev) {

+ if ((dst_key_flags(key) & DNS_KEYFLAG_REVOKE) != 0)

+ fprintf(stderr, "%s: warning: Key %s is already "

+ "revoked; removing the revocation date "

+ "will not affect this.\n",

+ program, keystr);

+ dst_key_unsettime(key, DST_TIME_REVOKE);

+ }

+

+ if (setinact)

+ dst_key_settime(key, DST_TIME_INACTIVE, inact);

+ else if (unsetinact)

+ dst_key_unsettime(key, DST_TIME_INACTIVE);

+

+ if (setdel)

+ dst_key_settime(key, DST_TIME_DELETE, del);

+ else if (unsetdel)

+ dst_key_unsettime(key, DST_TIME_DELETE);

+

+ /*

+ * Print out time values, if -p was used.

+ */

+ if (printcreate)

+ printtime(key, DST_TIME_CREATED, "Created", epoch, stdout);

+

+ if (printpub)

+ printtime(key, DST_TIME_PUBLISH, "Publish", epoch, stdout);

+

+ if (printact)

+ printtime(key, DST_TIME_ACTIVATE, "Activate", epoch, stdout);

+

+ if (printrev)

+ printtime(key, DST_TIME_REVOKE, "Revoke", epoch, stdout);

+

+ if (printinact)

+ printtime(key, DST_TIME_INACTIVE, "Inactive", epoch, stdout);

+

+ if (printdel)

+ printtime(key, DST_TIME_DELETE, "Delete", epoch, stdout);

+

+ if (changed) {

+ isc_buffer_init(&buf, newname, sizeof(newname));

+ result = dst_key_buildfilename(key, DST_TYPE_PUBLIC, directory,

+ &buf);

+ if (result != ISC_R_SUCCESS) {

+ fatal("Failed to build public key filename: %s",

+ isc_result_totext(result));

+ }

+

+ result = dst_key_tofile(key, DST_TYPE_PUBLIC|DST_TYPE_PRIVATE,

+ directory);

+ if (result != ISC_R_SUCCESS) {

+ dst_key_format(key, keystr, sizeof(keystr));

+ fatal("Failed to write key %s: %s", keystr,

+ isc_result_totext(result));

+ }

+

+ printf("%s\n", newname);

+

+ isc_buffer_clear(&buf);

+ result = dst_key_buildfilename(key, DST_TYPE_PRIVATE, directory,

+ &buf);

+ if (result != ISC_R_SUCCESS) {

+ fatal("Failed to build private key filename: %s",

+ isc_result_totext(result));

+ }

+ printf("%s\n", newname);

+ }

+

+ dst_key_free(&key);

+ dst_lib_destroy();

+ isc_hash_destroy();

+ cleanup_entropy(&ectx);

+ if (verbose > 10)

+ isc_mem_stats(mctx, stdout);

+ isc_mem_free(mctx, directory);

+ isc_mem_destroy(&mctx);

+

+ return (0);

+}

+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"

+ "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"

+ [<!ENTITY mdash "&#8212;">]>

+<!--

+ - Copyright (C) 2009, 2010 Internet Systems Consortium, Inc. ("ISC")

+ -

+ - Permission to use, copy, modify, and/or distribute this software for any

+ - purpose with or without fee is hereby granted, provided that the above

+ - copyright notice and this permission notice appear in all copies.

+ -

+ - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH

+ - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY

+ - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,

+ - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM

+ - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE

+ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR

+ - PERFORMANCE OF THIS SOFTWARE.

+-->

+

+<!-- $Id: dnssec-settime.docbook,v 1.11 2010-08-16 22:21:06 marka Exp $ -->

+<refentry id="man.dnssec-settime">

+ <refentryinfo>

+ <date>July 15, 2009</date>

+ </refentryinfo>

+

+ <refmeta>

+ <refentrytitle><application>dnssec-settime</application></refentrytitle>

+ <manvolnum>8</manvolnum>

+ <refmiscinfo>BIND9</refmiscinfo>

+ </refmeta>

+

+ <refnamediv>

+ <refname><application>dnssec-settime</application></refname>

+ <refpurpose>Set the key timing metadata for a DNSSEC key</refpurpose>

+ </refnamediv>

+

+ <docinfo>

+ <copyright>

+ <year>2009</year>

+ <year>2010</year>

+ <holder>Internet Systems Consortium, Inc. ("ISC")</holder>

+ </copyright>

+ </docinfo>

+

+ <refsynopsisdiv>

+ <cmdsynopsis>

+ <command>dnssec-settime</command>

+ <arg><option>-f</option></arg>

+ <arg><option>-K <replaceable class="parameter">directory</replaceable></option></arg>

+ <arg><option>-P <replaceable class="parameter">date/offset</replaceable></option></arg>

+ <arg><option>-A <replaceable class="parameter">date/offset</replaceable></option></arg>

+ <arg><option>-R <replaceable class="parameter">date/offset</replaceable></option></arg>

+ <arg><option>-I <replaceable class="parameter">date/offset</replaceable></option></arg>

+ <arg><option>-D <replaceable class="parameter">date/offset</replaceable></option></arg>

+ <arg><option>-h</option></arg>

+ <arg><option>-v <replaceable class="parameter">level</replaceable></option></arg>

+ <arg><option>-E <replaceable class="parameter">engine</replaceable></option></arg>

+ <arg choice="req">keyfile</arg>

+ </cmdsynopsis>

+ </refsynopsisdiv>

+

+ <refsect1>

+ <title>DESCRIPTION</title>

+ <para><command>dnssec-settime</command>

+ reads a DNSSEC private key file and sets the key timing metadata

+ as specified by the <option>-P</option>, <option>-A</option>,

+ <option>-R</option>, <option>-I</option>, and <option>-D</option>

+ options. The metadata can then be used by

+ <command>dnssec-signzone</command> or other signing software to

+ determine when a key is to be published, whether it should be

+ used for signing a zone, etc.

+ </para>

+ <para>

+ If none of these options is set on the command line,

+ then <command>dnssec-settime</command> simply prints the key timing

+ metadata already stored in the key.

+ </para>

+ <para>

+ When key metadata fields are changed, both files of a key

+ pair (<filename>Knnnn.+aaa+iiiii.key</filename> and

+ <filename>Knnnn.+aaa+iiiii.private</filename>) are regenerated.

+ Metadata fields are stored in the private file. A human-readable

+ description of the metadata is also placed in comments in the key

+ file.

+ </para>

+ </refsect1>

+

+ <refsect1>

+ <title>OPTIONS</title>

+

+ <variablelist>

+ <varlistentry>

+ <term>-f</term>

+ <listitem>

+ <para>

+ Force an update of an old-format key with no metadata fields.

+ Without this option, <command>dnssec-settime</command> will

+ fail when attempting to update a legacy key. With this option,

+ the key will be recreated in the new format, but with the

+ original key data retained. The key's creation date will be

+ set to the present time.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-K <replaceable class="parameter">directory</replaceable></term>

+ <listitem>

+ <para>

+ Sets the directory in which the key files are to reside.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-h</term>

+ <listitem>

+ <para>

+ Emit usage message and exit.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-v <replaceable class="parameter">level</replaceable></term>

+ <listitem>

+ <para>

+ Sets the debugging level.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-E <replaceable class="parameter">engine</replaceable></term>

+ <listitem>

+ <para>

+ Use the given OpenSSL engine. When compiled with PKCS#11 support

+ it defaults to pkcs11; the empty name resets it to no engine.

+ </para>

+ </listitem>

+ </varlistentry>

+ </variablelist>

+ </refsect1>

+

+ <refsect1>

+ <title>TIMING OPTIONS</title>

+ <para>

+ Dates can be expressed in the format YYYYMMDD or YYYYMMDDHHMMSS.

+ If the argument begins with a '+' or '-', it is interpreted as

+ an offset from the present time. For convenience, if such an offset

+ is followed by one of the suffixes 'y', 'mo', 'w', 'd', 'h', or 'mi',

+ then the offset is computed in years (defined as 365 24-hour days,

+ ignoring leap years), months (defined as 30 24-hour days), weeks,

+ days, hours, or minutes, respectively. Without a suffix, the offset

+ is computed in seconds. To unset a date, use 'none'.

+ </para>

+

+ <variablelist>

+ <varlistentry>

+ <term>-P <replaceable class="parameter">date/offset</replaceable></term>

+ <listitem>

+ <para>

+ Sets the date on which a key is to be published to the zone.

+ After that date, the key will be included in the zone but will

+ not be used to sign it.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-A <replaceable class="parameter">date/offset</replaceable></term>

+ <listitem>

+ <para>

+ Sets the date on which the key is to be activated. After that

+ date, the key will be included in the zone and used to sign

+ it.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-R <replaceable class="parameter">date/offset</replaceable></term>

+ <listitem>

+ <para>

+ Sets the date on which the key is to be revoked. After that

+ date, the key will be flagged as revoked. It will be included

+ in the zone and will be used to sign it.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-I <replaceable class="parameter">date/offset</replaceable></term>

+ <listitem>

+ <para>

+ Sets the date on which the key is to be retired. After that

+ date, the key will still be included in the zone, but it

+ will not be used to sign it.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-D <replaceable class="parameter">date/offset</replaceable></term>

+ <listitem>

+ <para>

+ Sets the date on which the key is to be deleted. After that

+ date, the key will no longer be included in the zone. (It

+ may remain in the key repository, however.)

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-S <replaceable class="parameter">predecessor key</replaceable></term>

+ <listitem>

+ <para>

+ Select a key for which the key being modified will be an

+ explicit successor. The name, algorithm, size, and type of the

+ predecessor key must exactly match those of the key being

+ modified. The activation date of the successor key will be set

+ to the inactivation date of the predecessor. The publication

+ date will be set to the activation date minus the prepublication

+ interval, which defaults to 30 days.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-i <replaceable class="parameter">interval</replaceable></term>

+ <listitem>

+ <para>

+ Sets the prepublication interval for a key. If set, then

+ the publication and activation dates must be separated by at least

+ this much time. If the activation date is specified but the

+ publication date isn't, then the publication date will default

+ to this much time before the activation date; conversely, if

+ the publication date is specified but activation date isn't,

+ then activation will be set to this much time after publication.

+ </para>

+ <para>

+ If the key is being set to be an explicit successor to another

+ key, then the default prepublication interval is 30 days;

+ otherwise it is zero.

+ </para>

+ <para>

+ As with date offsets, if the argument is followed by one of

+ the suffixes 'y', 'mo', 'w', 'd', 'h', or 'mi', then the

+ interval is measured in years, months, weeks, days, hours,

+ or minutes, respectively. Without a suffix, the interval is

+ measured in seconds.

+ </para>

+ </listitem>

+ </varlistentry>

+ </variablelist>

+ </refsect1>

+

+ <refsect1>

+ <title>PRINTING OPTIONS</title>

+ <para>

+ <command>dnssec-settime</command> can also be used to print the

+ timing metadata associated with a key.

+ </para>

+

+ <variablelist>

+ <varlistentry>

+ <term>-u</term>

+ <listitem>

+ <para>

+ Print times in UNIX epoch format.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ <varlistentry>

+ <term>-p <replaceable class="parameter">C/P/A/R/I/D/all</replaceable></term>

+ <listitem>

+ <para>

+ Print a specific metadata value or set of metadata values.

+ The <option>-p</option> option may be followed by one or more

+ of the following letters to indicate which value or values to print:

+ <option>C</option> for the creation date,

+ <option>P</option> for the publication date,

+ <option>A</option> for the activation date,

+ <option>R</option> for the revocation date,

+ <option>I</option> for the inactivation date, or

+ <option>D</option> for the deletion date.

+ To print all of the metadata, use <option>-p all</option>.

+ </para>

+ </listitem>

+ </varlistentry>

+

+ </variablelist>

+ </refsect1>

+

+ <refsect1>

+ <title>SEE ALSO</title>

+ <para><citerefentry>

+ <refentrytitle>dnssec-keygen</refentrytitle><manvolnum>8</manvolnum>

+ </citerefentry>,

+ <citerefentry>

+ <refentrytitle>dnssec-signzone</refentrytitle><manvolnum>8</manvolnum>

+ </citerefentry>,

+ <citetitle>BIND 9 Administrator Reference Manual</citetitle>,

+ <citetitle>RFC 5011</citetitle>.

+ </para>

+ </refsect1>

+

+ <refsect1>

+ <title>AUTHOR</title>

+ <para><corpauthor>Internet Systems Consortium</corpauthor>

+ </para>

+ </refsect1>

+

+</refentry><!--

+ - Local variables:

+ - mode: sgml

+ - End:

+-->

+<!--

+ - Copyright (C) 2009, 2010 Internet Systems Consortium, Inc. ("ISC")

+ -

+ - Permission to use, copy, modify, and/or distribute this software for any

+ - purpose with or without fee is hereby granted, provided that the above

+ - copyright notice and this permission notice appear in all copies.

+ -

+ - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH

+ - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY

+ - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,

+ - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM

+ - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE

+ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR

+ - PERFORMANCE OF THIS SOFTWARE.

+-->

+<!-- $Id: dnssec-settime.html,v 1.14 2010-08-17 01:15:26 tbox Exp $ -->

+<html>

+<head>

+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">

+<title>dnssec-settime</title>

+<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">

+</head>

+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en">

+<a name="man.dnssec-settime"></a><div class="titlepage"></div>

+<div class="refnamediv">

+<h2>Name</h2>

+<p><span class="application">dnssec-settime</span> &#8212; Set the key timing metadata for a DNSSEC key</p>

+</div>

+<div class="refsynopsisdiv">

+<h2>Synopsis</h2>

+<div class="cmdsynopsis"><p><code class="command">dnssec-settime</code> [<code class="option">-f</code>] [<code class="option">-K <em class="replaceable"><code>directory</code></em></code>] [<code class="option">-P <em class="replaceable"><code>date/offset</code></em></code>] [<code class="option">-A <em class="replaceable"><code>date/offset</code></em></code>] [<code class="option">-R <em class="replaceable"><code>date/offset</code></em></code>] [<code class="option">-I <em class="replaceable"><code>date/offset</code></em></code>] [<code class="option">-D <em class="replaceable"><code>date/offset</code></em></code>] [<code class="option">-h</code>] [<code class="option">-v <em class="replaceable"><code>level</code></em></code>] [<code class="option">-E <em class="replaceable"><code>engine</code></em></code>] {keyfile}</p></div>

+</div>

+<div class="refsect1" lang="en">

+<a name="id2543419"></a><h2>DESCRIPTION</h2>

+<p><span><strong class="command">dnssec-settime</strong></span>

+ reads a DNSSEC private key file and sets the key timing metadata

+ as specified by the <code class="option">-P</code>, <code class="option">-A</code>,

+ <code class="option">-R</code>, <code class="option">-I</code>, and <code class="option">-D</code>

+ options. The metadata can then be used by

+ <span><strong class="command">dnssec-signzone</strong></span> or other signing software to

+ determine when a key is to be published, whether it should be

+ used for signing a zone, etc.

+ </p>

+<p>

+ If none of these options is set on the command line,

+ then <span><strong class="command">dnssec-settime</strong></span> simply prints the key timing

+ metadata already stored in the key.

+ </p>

+<p>

+ When key metadata fields are changed, both files of a key

+ pair (<code class="filename">Knnnn.+aaa+iiiii.key</code> and

+ <code class="filename">Knnnn.+aaa+iiiii.private</code>) are regenerated.

+ Metadata fields are stored in the private file. A human-readable

+ description of the metadata is also placed in comments in the key

+ file.

+ </p>

+</div>

+<div class="refsect1" lang="en">

+<a name="id2543467"></a><h2>OPTIONS</h2>

+<div class="variablelist"><dl>

+<dt><span class="term">-f</span></dt>

+<dd><p>

+ Force an update of an old-format key with no metadata fields.

+ Without this option, <span><strong class="command">dnssec-settime</strong></span> will

+ fail when attempting to update a legacy key. With this option,

+ the key will be recreated in the new format, but with the

+ original key data retained. The key's creation date will be

+ set to the present time.

+ </p></dd>

+<dt><span class="term">-K <em class="replaceable"><code>directory</code></em></span></dt>

+<dd><p>

+ Sets the directory in which the key files are to reside.

+ </p></dd>

+<dt><span class="term">-h</span></dt>

+<dd><p>

+ Emit usage message and exit.

+ </p></dd>

+<dt><span class="term">-v <em class="replaceable"><code>level</code></em></span></dt>

+<dd><p>

+ Sets the debugging level.

+ </p></dd>

+<dt><span class="term">-E <em class="replaceable"><code>engine</code></em></span></dt>

+<dd><p>

+ Use the given OpenSSL engine. When compiled with PKCS#11 support

+ it defaults to pkcs11; the empty name resets it to no engine.

+ </p></dd>

+</dl></div>

+</div>

+<div class="refsect1" lang="en">

+<a name="id2543559"></a><h2>TIMING OPTIONS</h2>

+<p>

+ Dates can be expressed in the format YYYYMMDD or YYYYMMDDHHMMSS.

+ If the argument begins with a '+' or '-', it is interpreted as

+ an offset from the present time. For convenience, if such an offset

+ is followed by one of the suffixes 'y', 'mo', 'w', 'd', 'h', or 'mi',

+ then the offset is computed in years (defined as 365 24-hour days,

+ ignoring leap years), months (defined as 30 24-hour days), weeks,

+ days, hours, or minutes, respectively. Without a suffix, the offset

+ is computed in seconds. To unset a date, use 'none'.

+ </p>

+<div class="variablelist"><dl>

+<dt><span class="term">-P <em class="replaceable"><code>date/offset</code></em></span></dt>

+<dd><p>

+ Sets the date on which a key is to be published to the zone.

+ After that date, the key will be included in the zone but will

+ not be used to sign it.

+ </p></dd>

+<dt><span class="term">-A <em class="replaceable"><code>date/offset</code></em></span></dt>

+<dd><p>

+ Sets the date on which the key is to be activated. After that

+ date, the key will be included in the zone and used to sign

+ it.

+ </p></dd>

+<dt><span class="term">-R <em class="replaceable"><code>date/offset</code></em></span></dt>

+<dd><p>

+ Sets the date on which the key is to be revoked. After that

+ date, the key will be flagged as revoked. It will be included

+ in the zone and will be used to sign it.

+ </p></dd>

+<dt><span class="term">-I <em class="replaceable"><code>date/offset</code></em></span></dt>

+<dd><p>

+ Sets the date on which the key is to be retired. After that

+ date, the key will still be included in the zone, but it

+ will not be used to sign it.

+ </p></dd>

+<dt><span class="term">-D <em class="replaceable"><code>date/offset</code></em></span></dt>

+<dd><p>

+ Sets the date on which the key is to be deleted. After that

+ date, the key will no longer be included in the zone. (It

+ may remain in the key repository, however.)

+ </p></dd>

+<dt><span class="term">-S <em class="replaceable"><code>predecessor key</code></em></span></dt>

+<dd><p>

+ Select a key for which the key being modified will be an

+ explicit successor. The name, algorithm, size, and type of the

+ predecessor key must exactly match those of the key being

+ modified. The activation date of the successor key will be set

+ to the inactivation date of the predecessor. The publication

+ date will be set to the activation date minus the prepublication

+ interval, which defaults to 30 days.

+ </p></dd>

+<dt><span class="term">-i <em class="replaceable"><code>interval</code></em></span></dt>

+<dd>

+<p>

+ Sets the prepublication interval for a key. If set, then

+ the publication and activation dates must be separated by at least

+ this much time. If the activation date is specified but the

+ publication date isn't, then the publication date will default

+ to this much time before the activation date; conversely, if

+ the publication date is specified but activation date isn't,

+ then activation will be set to this much time after publication.

+ </p>

+<p>

+ If the key is being set to be an explicit successor to another

+ key, then the default prepublication interval is 30 days;

+ otherwise it is zero.

+ </p>

+<p>

+ As with date offsets, if the argument is followed by one of

+ the suffixes 'y', 'mo', 'w', 'd', 'h', or 'mi', then the

+ interval is measured in years, months, weeks, days, hours,

+ or minutes, respectively. Without a suffix, the interval is

+ measured in seconds.

+ </p>

+</dd>

+</dl></div>

+</div>

+<div class="refsect1" lang="en">

+<a name="id2543698"></a><h2>PRINTING OPTIONS</h2>

+<p>

+ <span><strong class="command">dnssec-settime</strong></span> can also be used to print the

+ timing metadata associated with a key.

+ </p>

+<div class="variablelist"><dl>

+<dt><span class="term">-u</span></dt>

+<dd><p>

+ Print times in UNIX epoch format.

+ </p></dd>

+<dt><span class="term">-p <em class="replaceable"><code>C/P/A/R/I/D/all</code></em></span></dt>

+<dd><p>

+ Print a specific metadata value or set of metadata values.

+ The <code class="option">-p</code> option may be followed by one or more

+ of the following letters to indicate which value or values to print:

+ <code class="option">C</code> for the creation date,

+ <code class="option">P</code> for the publication date,

+ <code class="option">A</code> for the activation date,

+ <code class="option">R</code> for the revocation date,

+ <code class="option">I</code> for the inactivation date, or

+ <code class="option">D</code> for the deletion date.

+ To print all of the metadata, use <code class="option">-p all</code>.

+ </p></dd>

+</dl></div>

+</div>

+<div class="refsect1" lang="en">

+<a name="id2543912"></a><h2>SEE ALSO</h2>

+<p><span class="citerefentry"><span class="refentrytitle">dnssec-keygen</span>(8)</span>,

+ <span class="citerefentry"><span class="refentrytitle">dnssec-signzone</span>(8)</span>,

+ <em class="citetitle">BIND 9 Administrator Reference Manual</em>,

+ <em class="citetitle">RFC 5011</em>.

+ </p>

+</div>

+<div class="refsect1" lang="en">

+<a name="id2543945"></a><h2>AUTHOR</h2>

+<p><span class="corpauthor">Internet Systems Consortium</span>

+ </p>

+</div>

+</div></body>

+</html>

+.\" $Id: dnssec-signzone.8,v 1.59 2009-12-04 01:13:44 tbox Exp $

+.\" Date: June 05, 2009

+.TH "DNSSEC\-SIGNZONE" "8" "June 05, 2009" "BIND9" "BIND9"

+\fBdnssec\-signzone\fR [\fB\-a\fR] [\fB\-c\ \fR\fB\fIclass\fR\fR] [\fB\-d\ \fR\fB\fIdirectory\fR\fR] [\fB\-E\ \fR\fB\fIengine\fR\fR] [\fB\-e\ \fR\fB\fIend\-time\fR\fR] [\fB\-f\ \fR\fB\fIoutput\-file\fR\fR] [\fB\-g\fR] [\fB\-h\fR] [\fB\-K\ \fR\fB\fIdirectory\fR\fR] [\fB\-k\ \fR\fB\fIkey\fR\fR] [\fB\-l\ \fR\fB\fIdomain\fR\fR] [\fB\-i\ \fR\fB\fIinterval\fR\fR] [\fB\-I\ \fR\fB\fIinput\-format\fR\fR] [\fB\-j\ \fR\fB\fIjitter\fR\fR] [\fB\-N\ \fR\fB\fIsoa\-serial\-format\fR\fR] [\fB\-o\ \fR\fB\fIorigin\fR\fR] [\fB\-O\ \fR\fB\fIoutput\-format\fR\fR] [\fB\-p\fR] [\fB\-P\fR] [\fB\-r\ \fR\fB\fIrandomdev\fR\fR] [\fB\-S\fR] [\fB\-s\ \fR\fB\fIstart\-time\fR\fR] [\fB\-T\ \fR\fB\fIttl\fR\fR] [\fB\-t\fR] [\fB\-u\fR] [\fB\-v\ \fR\fB\fIlevel\fR\fR] [\fB\-x\fR] [\fB\-z\fR] [\fB\-3\ \fR\fB\fIsalt\fR\fR] [\fB\-H\ \fR\fB\fIiterations\fR\fR] [\fB\-A\fR] {zonefile} [key...]

+signs a zone. It generates NSEC and RRSIG records and produces a signed version of the zone. The security status of delegations from the signed zone (that is, whether the child zones are secure or not) is determined by the presence or absence of a

+\fIkeyset\fR

+file for each child zone.

+\-C

+Compatibility mode: Generate a

+\fIkeyset\-\fR\fI\fIzonename\fR\fR

+file in addition to

+\fIdsset\-\fR\fI\fIzonename\fR\fR

+when signing a zone, for use by older versions of

+\fBdnssec\-signzone\fR.

+\fIdsset\-\fR

+or

+\fIkeyset\-\fR

+\fBdirectory\fR.

+.RE

+.PP

+\-E \fIengine\fR

+.RS 4

+Uses a crypto hardware (OpenSSL engine) for the crypto operations it supports, for instance signing with private keys from a secure key store. When compiled with PKCS#11 support it defaults to pkcs11; the empty name resets it to no engine.

+Generate DS records for child zones from

+\fIdsset\-\fR

+or

+file. Existing DS records will be removed.

+.RE

+.PP

+\-K \fIdirectory\fR

+.RS 4

+Key repository: Specify a directory to search for DNSSEC keys. If not specified, defaults to the current directory.

+.RE

+.PP

+\-k \fIkey\fR

+.RS 4

+Treat specified key as a key signing key ignoring any key flags. This option may be specified multiple times.

+.RE

+.PP

+\-l \fIdomain\fR

+.RS 4

+Generate a DLV set in addition to the key (DNSKEY) and DS sets. The domain is appended to the name of the records.

+\fBend\-time\fR

+must be later than

+\fBstart\-time\fR.

+\-S

+.RS 4

+Smart signing: Instructs

+\fBdnssec\-signzone\fR

+to search the key repository for keys that match the zone being signed, and to include them in the zone if appropriate.

+.sp

+When a key is found, its timing metadata is examined to determine how it should be used, according to the following rules. Each successive rule takes priority over the prior ones:

+.RS 4

+.PP

+.RS 4

+If no timing metadata has been set for the key, the key is published in the zone and used to sign the zone.

+.RE

+.PP

+.RS 4

+If the key's publication date is set and is in the past, the key is published in the zone.

+.RE

+.PP

+.RS 4

+If the key's activation date is set and in the past, the key is published (regardless of publication date) and used to sign the zone.

+.RE

+.PP

+.RS 4

+If the key's revocation date is set and in the past, and the key is published, then the key is revoked, and the revoked key is used to sign the zone.

+.RE

+.PP

+.RS 4

+If either of the key's unpublication or deletion dates are set and in the past, the key is NOT published or used to sign the zone, regardless of any other metadata.

+.RE

+.RE

+.RE

+.PP

+\-T \fIttl\fR

+.RS 4

+Specifies the TTL to be used for new DNSKEY records imported into the zone from the key repository. If not specified, the default is the minimum TTL value from the zone's SOA record. This option is ignored when signing without

+\fB\-S\fR, since DNSKEY records are not imported from the key repository in that case. It is also ignored if there are any pre\-existing DNSKEY records at the zone apex, in which case new records' TTL values will be set to match them.

+.RE

+.PP

+\-u

+.RS 4

+Update NSEC/NSEC3 chain when re\-signing a previously signed zone. With this option, a zone signed with NSEC can be switched to NSEC3, or a zone signed with NSEC3 can be switch to NSEC or to NSEC3 with different parameters. Without this option,

+\fBdnssec\-signzone\fR

+will retain the existing chain when re\-signing.

+.RE

+.PP

+\-x

+.RS 4

+Only sign the DNSKEY RRset with key\-signing keys, and omit signatures from zone\-signing keys. (This is similar to the

+\fBdnssec\-dnskey\-kskonly yes;\fR

+zone option in

+\fBnamed\fR.)

+.RE

+.PP

+Ignore KSK flag on key when determining what to sign. This causes KSK\-flagged keys to sign all records, not just the DNSKEY RRset. (This is similar to the

+\fBupdate\-check\-ksk no;\fR

+zone option in

+\fBnamed\fR.)

+Generate an NSEC3 chain with the given hex encoded salt. A dash (\fIsalt\fR) can be used to indicate that no salt is to be used when generating the NSEC3 chain.

+When generating an NSEC3 chain, use this many interations. The default is 10.

+When generating an NSEC3 chain set the OPTOUT flag on all NSEC3 records and do not generate NSEC3 records for insecure delegations.

+.sp

+Using this option twice (i.e.,

+\fB\-AA\fR) turns the OPTOUT flag off for all records. This is useful when using the

+\fB\-u\fR

+option to modify an NSEC3 chain which previously had OPTOUT set.

+(Kexample.com.+003+17247). Because the

+\fB\-S\fR

+option is not being used, the zone's keys must be in the master file (\fIdb.example.com\fR). This invocation looks for

+\fIdsset\fR

+files, in the current directory, so that DS records can be imported from them (\fB\-g\fR).

+/* $Id: dnssec-signzone.c,v 1.262 2010-06-03 23:51:04 tbox Exp $ */

+#ifndef PATH_MAX

+#define PATH_MAX 1024 /* AIX, WIN32, and others don't define this. */

+#endif

+

+#define REVOKE(x) ((dst_key_flags(x) & DNS_KEYFLAG_REVOKE) != 0)

+

+static dns_dnsseckeylist_t keylist;

+static dns_ttl_t zone_soa_min_ttl;

+static dns_ttl_t soa_ttl;

+static const char *directory = NULL, *dsdir = NULL;

+static dns_iterations_t nsec3iter = 10U;

+static unsigned char saltbuf[255];

+static unsigned char *salt = saltbuf;

+static size_t salt_length = 0;

+static isc_boolean_t ignore_kskflag = ISC_FALSE;

+static isc_boolean_t keyset_kskonly = ISC_FALSE;

+static isc_boolean_t update_chain = ISC_FALSE;

+static isc_boolean_t set_keyttl = ISC_FALSE;

+static dns_ttl_t keyttl;

+ char keystr[DST_KEY_FORMATSIZE];

+ dst_key_format(key, keystr, sizeof(keystr));

+ char keystr[DST_KEY_FORMATSIZE];

+ dst_key_format(key, keystr, sizeof(keystr));

+issigningkey(dns_dnsseckey_t *key) {

+ return (key->force_sign || key->hint_sign);

+iszonekey(dns_dnsseckey_t *key) {

+static inline isc_boolean_t

+isksk(dns_dnsseckey_t *key) {

+ return (key->ksk);

+}

+

+static inline isc_boolean_t

+iszsk(dns_dnsseckey_t *key) {

+ return (ignore_kskflag || !key->ksk);

+}

+

+ * Find the key that generated an RRSIG, if it is in the key list. If

+ * so, return a pointer to it, otherwise return NULL.

+ *

+static dns_dnsseckey_t *

+ dns_dnsseckey_t *key;

+ for (key = ISC_LIST_HEAD(keylist);

+ key != NULL;

+ key = ISC_LIST_NEXT(key, link)) {

+static dns_dnsseckey_t *

+ dns_dnsseckey_t *key = NULL;

+ directory, mctx, &pubkey);

+ directory, mctx, &privkey);

+ dns_dnsseckey_create(mctx, &privkey, &key);

+ } else {

+ dns_dnsseckey_create(mctx, &pubkey, &key);

+ }

+ key->force_publish = ISC_TRUE;

+ key->force_sign = ISC_FALSE;

+ /* NOTREACHED */

+setverifies(dns_name_t *name, dns_rdataset_t *set, dst_key_t *key,

+ result = dns_dnssec_verify(name, set, key, ISC_FALSE, mctx, rrsig);

+ dns_dnsseckey_t *key;

+ expecttofindkey(&rrsig.signer)) {

+ if (!expired && setverifies(name, set, key->key,

+ &sigrdata)) {

+ wassignedby[key->index] = ISC_TRUE;

+ nowsignedby[key->index] = ISC_TRUE;

+ wassignedby[key->index] = ISC_TRUE;

+ if (!expired && setverifies(name, set, key->key,

+ &sigrdata)) {

+ wassignedby[key->index] = ISC_TRUE;

+ nowsignedby[key->index] = ISC_TRUE;

+ wassignedby[key->index] = ISC_TRUE;

+ nowsignedby[key->index] = ISC_TRUE;

+ nowsignedby[key->index] = ISC_TRUE;

+ if (nowsignedby[key->index])

+ if (!issigningkey(key))

+ if (set->type == dns_rdatatype_dnskey &&

+ dns_name_equal(name, gorigin)) {

+ isc_boolean_t have_ksk;

+ dns_dnsseckey_t *tmpkey;

+

+ have_ksk = isksk(key);

+ for (tmpkey = ISC_LIST_HEAD(keylist);

+ tmpkey != NULL;

+ tmpkey = ISC_LIST_NEXT(tmpkey, link)) {

+ if (dst_key_alg(key->key) !=

+ dst_key_alg(tmpkey->key))

+ continue;

+ if (REVOKE(tmpkey->key))

+ continue;

+ if (isksk(tmpkey))

+ have_ksk = ISC_TRUE;

+ }

+ if (isksk(key) || !have_ksk ||

+ (iszsk(key) && !keyset_kskonly))

+ signwithkey(name, set, key->key, ttl, add,

+ "signing with dnskey");

+ } else if (iszsk(key)) {

+ signwithkey(name, set, key->key, ttl, add,

+ "signing with dnskey");

+ }

+ char filename[PATH_MAX];

+ if (dsdir != NULL) {

+ /* allow room for a trailing slash */

+ if (strlen(dsdir) >= isc_buffer_availablelength(&b))

+ fatal("path '%s' is too long", dsdir);

+ isc_buffer_putstr(&b, dsdir);

+ if (dsdir[strlen(dsdir) - 1] != '/')

+ if (strlen(prefix) > isc_buffer_availablelength(&b))

+ fatal("path '%s' is too long", dsdir);

+ result = dns_db_load3(*dbp, filename, inputformat, DNS_MASTER_HINT);

+ * Load the DS set for a child zone, if a dsset-* file can be found.

+ * If not, try to find a keyset-* file from an earlier version of

+ * dnssec-signzone, and build DS records from that.

+ opendb("dsset-", name, gclass, &db);

+ if (db != NULL) {

+ result = dns_db_findnode(db, name, ISC_FALSE, &node);

+ if (result == ISC_R_SUCCESS) {

+ dns_rdataset_init(dsset);

+ result = dns_db_findrdataset(db, node, NULL,

+ dns_rdatatype_ds, 0, 0,

+ dsset, NULL);

+ dns_db_detachnode(db, &node);

+ if (result == ISC_R_SUCCESS) {

+ vbprintf(2, "found DS records\n");

+ dsset->ttl = ttl;

+ dns_db_detach(&db);

+ return (result);

+ }

+ }

+ dns_db_detach(&db);

+ }

+

+ /* No DS records found; try again, looking for DNSKEY records */

+ if (db == NULL) {

+ }

+ return (result);

+

+ result = dns_db_findrdataset(db, node, NULL, dns_rdatatype_dnskey, 0, 0,

+ &keyset, NULL);

+

+ * Extracts the minimum TTL from the SOA record, and the SOA record's TTL.

+static void

+get_soa_ttls(void) {

+ zone_soa_min_ttl = dns_soa_getminimum(&rdata);

+ soa_ttl = soaset.ttl;

+ dns_secalg_format(i, algbuf, sizeof(algbuf));

+ * The apex has a DNSKEY record with at least one KSK, and at least

+ * one ZSK if the -x flag was not used.

+ unsigned char revoked_ksk[256];

+ unsigned char revoked_zsk[256];

+ unsigned char standby_ksk[256];

+ unsigned char standby_zsk[256];

+ memset(revoked_ksk, 0, sizeof(revoked_ksk));

+ memset(revoked_zsk, 0, sizeof(revoked_zsk));

+ memset(standby_ksk, 0, sizeof(standby_ksk));

+ memset(standby_zsk, 0, sizeof(standby_zsk));

+ * Check that the DNSKEY RR has at least one self signing KSK

+ * and one ZSK per algorithm in it (or, if -x was used, one

+ * self-signing KSK).

+ revoked_ksk[dnskey.algorithm] != 255)

+ revoked_ksk[dnskey.algorithm]++;

+ else if ((dnskey.flags & DNS_KEYFLAG_KSK) == 0 &&

+ revoked_zsk[dnskey.algorithm] != 255)

+ revoked_zsk[dnskey.algorithm]++;

+ if (standby_ksk[dnskey.algorithm] != 255)

+ standby_ksk[dnskey.algorithm]++;

+ if (standby_zsk[dnskey.algorithm] != 255)

+ standby_zsk[dnskey.algorithm]++;

+ if (!goodksk) {

+ if (!ignore_kskflag)

+ fprintf(stderr, "No self signing KSK found. Using "

+ "self signed ZSK's for active "

+ "algorithm list.\n");

+ }

+ if (!goodksk) {

+#endif

+#ifdef ALLOW_KSKLESS_ZONES

+ if (ksk_algorithms[i] != 0 || zsk_algorithms[i] != 0)

+#else

+ if (ksk_algorithms[i] != 0)

+#endif

+ {

+ dns_secalg_format(i, algbuf, sizeof(algbuf));

+ if (!ignore_kskflag && !keyset_kskonly) {

+ for (i = 0; i < 256; i++) {

+ /*

+ * The counts should both be zero or both be non-zero.

+ * Mark the algorithm as bad if this is not met.

+ */

+ if ((ksk_algorithms[i] != 0) ==

+ (zsk_algorithms[i] != 0))

+ continue;

+ dns_secalg_format(i, algbuf, sizeof(algbuf));

+ fprintf(stderr, "Missing %s for algorithm %s\n",

+ (ksk_algorithms[i] != 0)

+ ? "ZSK"

+ : "self signing KSK",

+ algbuf);

+ bad_algorithms[i] = 1;

+ }

+ dns_secalg_format(i, algbuf, sizeof(algbuf));

+ if (goodksk || ignore_kskflag) {

+ if ((ksk_algorithms[i] != 0) ||

+ (standby_ksk[i] != 0) ||

+ (revoked_zsk[i] != 0) ||

+ (zsk_algorithms[i] != 0) ||

+ (standby_zsk[i] != 0) ||

+ (revoked_zsk[i] != 0)) {

+ dns_secalg_format(i, algbuf, sizeof(algbuf));

+ fprintf(stderr, "Algorithm: %s: KSKs: "

+ "%u active, %u stand-by, %u revoked\n",

+ algbuf, ksk_algorithms[i],

+ standby_ksk[i], revoked_ksk[i]);

+ fprintf(stderr, "%*sZSKs: "

+ "%u active, %u %s, %u revoked\n",

+ (int) strlen(algbuf) + 13, "",

+ zsk_algorithms[i],

+ standby_zsk[i],

+ keyset_kskonly ? "present" : "stand-by",

+ revoked_zsk[i]);

+

+ * Delete any records of the given type at the apex.

+ if (which == dns_rdatatype_nsec && !update_chain)

+ fatal("Zone contains NSEC records. Use -u "

+ "to update to NSEC3.");

+ if (which == dns_rdatatype_nsec3param && !update_chain)

+ fatal("Zone contains NSEC3 chains. Use -u "

+ "to update to NSEC.");

+ dns_dbiterator_pause(dbiter);

+ zone_soa_min_ttl);

+static void

+rrset_remove_duplicates(dns_name_t *name, dns_rdataset_t *rdataset,

+ dns_diff_t *diff)

+{

+ dns_difftuple_t *tuple = NULL;

+ isc_result_t result;

+ unsigned int count1 = 0;

+ dns_rdataset_t tmprdataset;

+

+ dns_rdataset_init(&tmprdataset);

+ for (result = dns_rdataset_first(rdataset);

+ result == ISC_R_SUCCESS;

+ result = dns_rdataset_next(rdataset)) {

+ dns_rdata_t rdata1 = DNS_RDATA_INIT;

+ unsigned int count2 = 0;

+

+ count1++;

+ dns_rdataset_current(rdataset, &rdata1);

+ dns_rdataset_clone(rdataset, &tmprdataset);

+ for (result = dns_rdataset_first(&tmprdataset);

+ result == ISC_R_SUCCESS;

+ result = dns_rdataset_next(&tmprdataset)) {

+ dns_rdata_t rdata2 = DNS_RDATA_INIT;

+ count2++;

+ if (count1 >= count2)

+ continue;

+ dns_rdataset_current(&tmprdataset, &rdata2);

+ if (dns_rdata_casecompare(&rdata1, &rdata2) == 0) {

+ result = dns_difftuple_create(mctx,

+ DNS_DIFFOP_DEL,

+ name,

+ rdataset->ttl,

+ &rdata2, &tuple);

+ check_result(result, "dns_difftuple_create");

+ dns_diff_append(diff, &tuple);

+ }

+ }

+ dns_rdataset_disassociate(&tmprdataset);

+ }

+}

+

+static void

+remove_duplicates(void) {

+ isc_result_t result;

+ dns_dbiterator_t *dbiter = NULL;

+ dns_rdatasetiter_t *rdsiter = NULL;

+ dns_diff_t diff;

+ dns_dbnode_t *node = NULL;

+ dns_rdataset_t rdataset;

+ dns_fixedname_t fname;

+ dns_name_t *name;

+

+ dns_diff_init(mctx, &diff);

+ dns_fixedname_init(&fname);

+ name = dns_fixedname_name(&fname);

+ dns_rdataset_init(&rdataset);

+

+ result = dns_db_createiterator(gdb, 0, &dbiter);

+ check_result(result, "dns_db_createiterator()");

+

+ for (result = dns_dbiterator_first(dbiter);

+ result == ISC_R_SUCCESS;

+ result = dns_dbiterator_next(dbiter)) {

+

+ result = dns_dbiterator_current(dbiter, &node, name);

+ check_dns_dbiterator_current(result);

+ result = dns_db_allrdatasets(gdb, node, gversion, 0, &rdsiter);

+ check_result(result, "dns_db_allrdatasets()");

+ for (result = dns_rdatasetiter_first(rdsiter);

+ result == ISC_R_SUCCESS;

+ result = dns_rdatasetiter_next(rdsiter)) {

+ dns_rdatasetiter_current(rdsiter, &rdataset);

+ rrset_remove_duplicates(name, &rdataset, &diff);

+ dns_rdataset_disassociate(&rdataset);

+ }

+ if (result != ISC_R_NOMORE)

+ fatal("rdatasets iteration failed.");

+ dns_rdatasetiter_destroy(&rdsiter);

+ dns_db_detachnode(gdb, &node);

+ }

+ if (result != ISC_R_NOMORE)

+ fatal("zone iteration failed.");

+

+ if (!ISC_LIST_EMPTY(diff.tuples)) {

+ result = dns_diff_applysilently(&diff, gdb, gversion);

+ check_result(result, "dns_diff_applysilently");

+ }

+ dns_diff_clear(&diff);

+ dns_dbiterator_destroy(&dbiter);

+}

+

+ hashlist, zone_soa_min_ttl);

+ iterations, hashlist, zone_soa_min_ttl);

+ result = dns_name_fromtext(name, &b, dns_rootname, 0, NULL);

+loadzonekeys(isc_boolean_t preserve_keys, isc_boolean_t load_public) {

+ dns_dbversion_t *currentversion = NULL;

+ dns_rdataset_t rdataset, keysigs, soasigs;

+ result = dns_db_findnode(gdb, gorigin, ISC_FALSE, &node);

+ dns_db_currentversion(gdb, &currentversion);

+

+ dns_rdataset_init(&rdataset);

+ dns_rdataset_init(&soasigs);

+ dns_rdataset_init(&keysigs);

+

+ /* Make note of the keys which signed the SOA, if any */

+ result = dns_db_findrdataset(gdb, node, currentversion,

+ dns_rdatatype_soa, 0, 0,

+ &rdataset, &soasigs);

+ if (result != ISC_R_SUCCESS)

+ goto cleanup;

+

+ /* Preserve the TTL of the DNSKEY RRset, if any */

+ dns_rdataset_disassociate(&rdataset);

+ result = dns_db_findrdataset(gdb, node, currentversion,

+ dns_rdatatype_dnskey, 0, 0,

+ &rdataset, &keysigs);

+

+ goto cleanup;

+

+ if (set_keyttl && keyttl != rdataset.ttl) {

+ fprintf(stderr, "User-specified TTL (%d) conflicts "

+ "with existing DNSKEY RRset TTL.\n",

+ keyttl);

+ fprintf(stderr, "Imported keys will use the RRSet "

+ "TTL (%d) instead.\n",

+ rdataset.ttl);

+ }

+ keyttl = rdataset.ttl;

+

+ /* Load keys corresponding to the existing DNSKEY RRset */

+ result = dns_dnssec_keylistfromrdataset(gorigin, directory, mctx,

+ &rdataset, &keysigs, &soasigs,

+ preserve_keys, load_public,

+ &keylist);

+ if (result != ISC_R_SUCCESS)

+ fatal("failed to load the zone keys: %s",

+ cleanup:

+ if (dns_rdataset_isassociated(&rdataset))

+ dns_rdataset_disassociate(&rdataset);

+ if (dns_rdataset_isassociated(&keysigs))

+ dns_rdataset_disassociate(&keysigs);

+ if (dns_rdataset_isassociated(&soasigs))

+ dns_rdataset_disassociate(&soasigs);

+ dns_db_detachnode(gdb, &node);

+ dns_db_closeversion(gdb, &currentversion, ISC_FALSE);

+}

+

+static void

+loadexplicitkeys(char *keyfiles[], int n, isc_boolean_t setksk) {

+ isc_result_t result;

+ int i;

+

+ for (i = 0; i < n; i++) {

+ dns_dnsseckey_t *key = NULL;

+ dst_key_t *newkey = NULL;

+

+ result = dst_key_fromnamedfile(keyfiles[i], directory,

+ DST_TYPE_PUBLIC |

+ DST_TYPE_PRIVATE,

+ mctx, &newkey);

+ if (result != ISC_R_SUCCESS)

+ fatal("cannot load dnskey %s: %s", keyfiles[i],

+ isc_result_totext(result));

+

+ if (!dns_name_equal(gorigin, dst_key_name(newkey)))

+ fatal("key %s not at origin\n", keyfiles[i]);

+

+ if (!dst_key_isprivate(newkey))

+ fatal("cannot sign zone with non-private dnskey %s",

+ keyfiles[i]);

+

+ /* Skip any duplicates */

+ for (key = ISC_LIST_HEAD(keylist);

+ key != NULL;

+ key = ISC_LIST_NEXT(key, link)) {

+ if (dst_key_id(key->key) == dst_key_id(newkey) &&

+ dst_key_alg(key->key) == dst_key_alg(newkey))

+ break;

+ }

+

+ if (key == NULL) {

+ /* We haven't seen this key before */

+ dns_dnsseckey_create(mctx, &newkey, &key);

+ ISC_LIST_APPEND(keylist, key, link);

+ key->source = dns_keysource_user;

+ } else {

+ dst_key_free(&key->key);

+ key->key = newkey;

+ }

+

+ key->force_publish = ISC_TRUE;

+ key->force_sign = ISC_TRUE;

+ if (setksk)

+ key->ksk = ISC_TRUE;