man.dnssec-settime.html revision 32098293b78922a5fbd10906afa28624820d3756
5f5870385cff47efd2f58e7892f251cf13761528Timo Sirainen<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen - Copyright (C) 2000-2017 Internet Systems Consortium, Inc. ("ISC")
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen - This Source Code Form is subject to the terms of the Mozilla Public
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen - License, v. 2.0. If a copy of the MPL was not distributed with this
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen - file, You can obtain one at http://mozilla.org/MPL/2.0/.
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen<link rel="home" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen<link rel="up" href="Bv9ARM.ch13.html" title="Manual pages">
2615df45a8027948a474abe5e817b34b0499c171Timo Sirainen<link rel="prev" href="man.dnssec-revoke.html" title="dnssec-revoke">
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen<link rel="next" href="man.dnssec-signzone.html" title="dnssec-signzone">
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen<table width="100%" summary="Navigation header">
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen<tr><th colspan="3" align="center"><span class="application">dnssec-settime</span></th></tr>
35283613d4c04ce18836e9fc431582c87b3710a0Timo Sirainen<a accesskey="p" href="man.dnssec-revoke.html">Prev</a>�</td>
35283613d4c04ce18836e9fc431582c87b3710a0Timo Sirainen<th width="60%" align="center">Manual pages</th>
35283613d4c04ce18836e9fc431582c87b3710a0Timo Sirainen<td width="20%" align="right">�<a accesskey="n" href="man.dnssec-signzone.html">Next</a>
910fa4e4204a73d3d24c03f3059dd24e727ca057Timo Sirainen<a name="man.dnssec-settime"></a><div class="titlepage"></div>
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen <span class="application">dnssec-settime</span>
83bb013a99f0936995f9c7a1077822662d8fefdbTimo Sirainen — set the key timing metadata for a DNSSEC key
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen [<code class="option">-K <em class="replaceable"><code>directory</code></em></code>]
ae1b268ffff743ad9927c304a1344c5cbd7f909dTimo Sirainen [<code class="option">-L <em class="replaceable"><code>ttl</code></em></code>]
83bb013a99f0936995f9c7a1077822662d8fefdbTimo Sirainen [<code class="option">-P <em class="replaceable"><code>date/offset</code></em></code>]
83bb013a99f0936995f9c7a1077822662d8fefdbTimo Sirainen [<code class="option">-P sync <em class="replaceable"><code>date/offset</code></em></code>]
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen [<code class="option">-A <em class="replaceable"><code>date/offset</code></em></code>]
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen [<code class="option">-R <em class="replaceable"><code>date/offset</code></em></code>]
83bb013a99f0936995f9c7a1077822662d8fefdbTimo Sirainen [<code class="option">-I <em class="replaceable"><code>date/offset</code></em></code>]
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen [<code class="option">-D <em class="replaceable"><code>date/offset</code></em></code>]
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen [<code class="option">-D sync <em class="replaceable"><code>date/offset</code></em></code>]
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen [<code class="option">-v <em class="replaceable"><code>level</code></em></code>]
ae1b268ffff743ad9927c304a1344c5cbd7f909dTimo Sirainen [<code class="option">-E <em class="replaceable"><code>engine</code></em></code>]
ae1b268ffff743ad9927c304a1344c5cbd7f909dTimo Sirainen<a name="id-1.14.15.7"></a><h2>DESCRIPTION</h2>
83bb013a99f0936995f9c7a1077822662d8fefdbTimo Sirainen <p><span class="command"><strong>dnssec-settime</strong></span>
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen reads a DNSSEC private key file and sets the key timing metadata
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen as specified by the <code class="option">-P</code>, <code class="option">-A</code>,
83bb013a99f0936995f9c7a1077822662d8fefdbTimo Sirainen <code class="option">-R</code>, <code class="option">-I</code>, and <code class="option">-D</code>
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen options. The metadata can then be used by
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen <span class="command"><strong>dnssec-signzone</strong></span> or other signing software to
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen determine when a key is to be published, whether it should be
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen used for signing a zone, etc.
83bb013a99f0936995f9c7a1077822662d8fefdbTimo Sirainen If none of these options is set on the command line,
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen then <span class="command"><strong>dnssec-settime</strong></span> simply prints the key timing
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen metadata already stored in the key.
75f3dddc3a5922c92a1bdb921b653ead51227cabTimo Sirainen When key metadata fields are changed, both files of a key
83bb013a99f0936995f9c7a1077822662d8fefdbTimo Sirainen pair (<code class="filename">Knnnn.+aaa+iiiii.key</code> and
83bb013a99f0936995f9c7a1077822662d8fefdbTimo Sirainen <code class="filename">Knnnn.+aaa+iiiii.private</code>) are regenerated.
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen Metadata fields are stored in the private file. A human-readable
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen description of the metadata is also placed in comments in the key
83bb013a99f0936995f9c7a1077822662d8fefdbTimo Sirainen file. The private file's permissions are always set to be
6df0ab0c1ab91f06b6418cb30eff44405a1b8f02Timo Sirainen inaccessible to anyone other than the owner (mode 0600).
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen <div class="variablelist"><dl class="variablelist">
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen Force an update of an old-format key with no metadata fields.
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen Without this option, <span class="command"><strong>dnssec-settime</strong></span> will
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen fail when attempting to update a legacy key. With this option,
910fa4e4204a73d3d24c03f3059dd24e727ca057Timo Sirainen the key will be recreated in the new format, but with the
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen original key data retained. The key's creation date will be
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen set to the present time. If no other values are specified,
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen then the key's publication and activation dates will also
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen be set to the present time.
573f0491a5733fe21fa062a455acb4790b4e0499Timo Sirainen<dt><span class="term">-K <em class="replaceable"><code>directory</code></em></span></dt>
6564208826b0f46a00f010d1b5711d85944c3c88Timo Sirainen Sets the directory in which the key files are to reside.
6564208826b0f46a00f010d1b5711d85944c3c88Timo Sirainen<dt><span class="term">-L <em class="replaceable"><code>ttl</code></em></span></dt>
83bb013a99f0936995f9c7a1077822662d8fefdbTimo Sirainen Sets the default TTL to use for this key when it is converted
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen into a DNSKEY RR. If the key is imported into a zone,
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen this is the TTL that will be used for it, unless there was
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen already a DNSKEY RRset in place, in which case the existing TTL
0d86aa0d47f7393c669c084b34c0537b193688adTimo Sirainen would take precedence. If this value is not set and there
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen is no existing DNSKEY RRset, the TTL will default to the
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen SOA TTL. Setting the default TTL to <code class="literal">0</code>
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen or <code class="literal">none</code> removes it from the key.
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen Emit usage message and exit.
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen Prints version information.
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen<dt><span class="term">-v <em class="replaceable"><code>level</code></em></span></dt>
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen Sets the debugging level.
9af6cc9ebc9986c1275ebdfa29c39e152af1557eTimo Sirainen<dt><span class="term">-E <em class="replaceable"><code>engine</code></em></span></dt>
ad48319996942463675b53877092ab7e13a7a75aTimo Sirainen Specifies the cryptographic hardware to use, when applicable.
6564208826b0f46a00f010d1b5711d85944c3c88Timo Sirainen When BIND is built with OpenSSL PKCS#11 support, this defaults
6564208826b0f46a00f010d1b5711d85944c3c88Timo Sirainen to the string "pkcs11", which identifies an OpenSSL engine
c6a57378d3c54988f525f81e19c0c5d132a0770dTimo Sirainen that can drive a cryptographic accelerator or hardware service