man.dnssec-signzone.html revision b4556ecdbc3cad55e1c85ce32b73b7bcd39e43dc
5fbced719b71e659322b4ce3e4a39c9b039674c7Bob Halley - Copyright (C) 2004-2015 Internet Systems Consortium, Inc. ("ISC")
4b598d8ae578861d5f3fc1333c9f84c9c9c8be7cDavid Lawrence - Copyright (C) 2000-2003 Internet Software Consortium.
5fbced719b71e659322b4ce3e4a39c9b039674c7Bob Halley - Permission to use, copy, modify, and/or distribute this software for any
5fbced719b71e659322b4ce3e4a39c9b039674c7Bob Halley - purpose with or without fee is hereby granted, provided that the above
5fbced719b71e659322b4ce3e4a39c9b039674c7Bob Halley - copyright notice and this permission notice appear in all copies.
15a44745412679c30a6d022733925af70a38b715David Lawrence - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
15a44745412679c30a6d022733925af70a38b715David Lawrence - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
15a44745412679c30a6d022733925af70a38b715David Lawrence - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
15a44745412679c30a6d022733925af70a38b715David Lawrence - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
15a44745412679c30a6d022733925af70a38b715David Lawrence - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
15a44745412679c30a6d022733925af70a38b715David Lawrence - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
15a44745412679c30a6d022733925af70a38b715David Lawrence - PERFORMANCE OF THIS SOFTWARE.
5a6e6c2c9b2f6cf426aa2a682aa800765e26d540Andreas Gustafsson<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
5a6e6c2c9b2f6cf426aa2a682aa800765e26d540Andreas Gustafsson<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
5a6e6c2c9b2f6cf426aa2a682aa800765e26d540Andreas Gustafsson<link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<link rel="up" href="Bv9ARM.ch13.html" title="Manual pages">
5a6e6c2c9b2f6cf426aa2a682aa800765e26d540Andreas Gustafsson<link rel="prev" href="man.dnssec-settime.html" title="dnssec-settime">
5a6e6c2c9b2f6cf426aa2a682aa800765e26d540Andreas Gustafsson<link rel="next" href="man.dnssec-verify.html" title="dnssec-verify">
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<table width="100%" summary="Navigation header">
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<tr><th colspan="3" align="center"><span class="application">dnssec-signzone</span></th></tr>
5a6e6c2c9b2f6cf426aa2a682aa800765e26d540Andreas Gustafsson<a accesskey="p" href="man.dnssec-settime.html">Prev</a>�</td>
5a6e6c2c9b2f6cf426aa2a682aa800765e26d540Andreas Gustafsson<th width="60%" align="center">Manual pages</th>
5a6e6c2c9b2f6cf426aa2a682aa800765e26d540Andreas Gustafsson<td width="20%" align="right">�<a accesskey="n" href="man.dnssec-verify.html">Next</a>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<a name="man.dnssec-signzone"></a><div class="titlepage"></div>
b897c52f865b2fc4e220e2110b874e59c716456bBob Halley<p><span class="application">dnssec-signzone</span> — DNSSEC zone signing tool</p>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<div class="cmdsynopsis"><p><code class="command">dnssec-signzone</code> [<code class="option">-a</code>] [<code class="option">-c <em class="replaceable"><code>class</code></em></code>] [<code class="option">-d <em class="replaceable"><code>directory</code></em></code>] [<code class="option">-D</code>] [<code class="option">-E <em class="replaceable"><code>engine</code></em></code>] [<code class="option">-e <em class="replaceable"><code>end-time</code></em></code>] [<code class="option">-f <em class="replaceable"><code>output-file</code></em></code>] [<code class="option">-g</code>] [<code class="option">-h</code>] [<code class="option">-K <em class="replaceable"><code>directory</code></em></code>] [<code class="option">-k <em class="replaceable"><code>key</code></em></code>] [<code class="option">-L <em class="replaceable"><code>serial</code></em></code>] [<code class="option">-l <em class="replaceable"><code>domain</code></em></code>] [<code class="option">-M <em class="replaceable"><code>domain</code></em></code>] [<code class="option">-i <em class="replaceable"><code>interval</code></em></code>] [<code class="option">-I <em class="replaceable"><code>input-format</code></em></code>] [<code class="option">-j <em class="replaceable"><code>jitter</code></em></code>] [<code class="option">-N <em class="replaceable"><code>soa-serial-format</code></em></code>] [<code class="option">-o <em class="replaceable"><code>origin</code></em></code>] [<code class="option">-O <em class="replaceable"><code>output-format</code></em></code>] [<code class="option">-P</code>] [<code class="option">-p</code>] [<code class="option">-Q</code>] [<code class="option">-R</code>] [<code class="option">-r <em class="replaceable"><code>randomdev</code></em></code>] [<code class="option">-S</code>] [<code class="option">-s <em class="replaceable"><code>start-time</code></em></code>] [<code class="option">-T <em class="replaceable"><code>ttl</code></em></code>] [<code class="option">-t</code>] [<code class="option">-u</code>] [<code class="option">-v <em class="replaceable"><code>level</code></em></code>] [<code class="option">-V</code>] [<code class="option">-X <em class="replaceable"><code>extended end-time</code></em></code>] [<code class="option">-x</code>] [<code class="option">-z</code>] [<code class="option">-3 <em class="replaceable"><code>salt</code></em></code>] [<code class="option">-H <em class="replaceable"><code>iterations</code></em></code>] [<code class="option">-A</code>] {zonefile} [key...]</p></div>
4b598d8ae578861d5f3fc1333c9f84c9c9c8be7cDavid Lawrence<p><span><strong class="command">dnssec-signzone</strong></span>
4b598d8ae578861d5f3fc1333c9f84c9c9c8be7cDavid Lawrence signs a zone. It generates
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence NSEC and RRSIG records and produces a signed version of the
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence zone. The security status of delegations from the signed zone
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence (that is, whether the child zones are secure or not) is
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence determined by the presence or absence of a
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence <code class="filename">keyset</code> file for each child zone.
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence Verify all generated signatures.
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<dt><span class="term">-c <em class="replaceable"><code>class</code></em></span></dt>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence Specifies the DNS class of the zone.
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence Compatibility mode: Generate a
86cbec9012b1db3f85789155c38d10c63a96156fAndreas Gustafsson <code class="filename">keyset-<em class="replaceable"><code>zonename</code></em></code>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence file in addition to
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence <code class="filename">dsset-<em class="replaceable"><code>zonename</code></em></code>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence when signing a zone, for use by older versions of
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence <span><strong class="command">dnssec-signzone</strong></span>.
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<dt><span class="term">-d <em class="replaceable"><code>directory</code></em></span></dt>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence Look for <code class="filename">dsset-</code> or
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence <code class="filename">keyset-</code> files in <code class="option">directory</code>.
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence Output only those record types automatically managed by
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence <span><strong class="command">dnssec-signzone</strong></span>, i.e. RRSIG, NSEC,
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence NSEC3 and NSEC3PARAM records. If smart signing
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence (<code class="option">-S</code>) is used, DNSKEY records are also
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence included. The resulting file can be included in the original
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence zone file with <span><strong class="command">$INCLUDE</strong></span>. This option
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence cannot be combined with <code class="option">-O raw</code>,
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence <code class="option">-O map</code>, or serial number updating.
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<dt><span class="term">-E <em class="replaceable"><code>engine</code></em></span></dt>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence When applicable, specifies the hardware to use for
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence cryptographic operations, such as a secure key store used
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence When BIND is built with OpenSSL PKCS#11 support, this defaults
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence to the string "pkcs11", which identifies an OpenSSL engine
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence that can drive a cryptographic accelerator or hardware service
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence module. When BIND is built with native PKCS#11 cryptography
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence (--enable-native-pkcs11), it defaults to the path of the PKCS#11
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence provider library specified via "--with-pkcs11".
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence Generate DS records for child zones from
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence <code class="filename">dsset-</code> or <code class="filename">keyset-</code>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence file. Existing DS records will be removed.
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<dt><span class="term">-K <em class="replaceable"><code>directory</code></em></span></dt>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence Key repository: Specify a directory to search for DNSSEC keys.
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence If not specified, defaults to the current directory.
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<dt><span class="term">-k <em class="replaceable"><code>key</code></em></span></dt>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence Treat specified key as a key signing key ignoring any
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence key flags. This option may be specified multiple times.
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<dt><span class="term">-l <em class="replaceable"><code>domain</code></em></span></dt>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence Generate a DLV set in addition to the key (DNSKEY) and DS sets.
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence The domain is appended to the name of the records.
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<dt><span class="term">-M <em class="replaceable"><code>maxttl</code></em></span></dt>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence Sets the maximum TTL for the signed zone.
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence Any TTL higher than <em class="replaceable"><code>maxttl</code></em> in the
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence input zone will be reduced to <em class="replaceable"><code>maxttl</code></em>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence in the output. This provides certainty as to the largest
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence possible TTL in the signed zone, which is useful to know when
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence rolling keys because it is the longest possible time before
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence signatures that have been retrieved by resolvers will expire
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence from resolver caches. Zones that are signed with this
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence option should be configured to use a matching
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence <code class="option">max-zone-ttl</code> in <code class="filename">named.conf</code>.
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence (Note: This option is incompatible with <code class="option">-D</code>,
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence because it modifies non-DNSSEC data in the output zone.)
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<dt><span class="term">-s <em class="replaceable"><code>start-time</code></em></span></dt>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence Specify the date and time when the generated RRSIG records
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence become valid. This can be either an absolute or relative
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence time. An absolute start time is indicated by a number
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence in YYYYMMDDHHMMSS notation; 20000530144500 denotes
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence 14:45:00 UTC on May 30th, 2000. A relative start time is
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence indicated by +N, which is N seconds from the current time.
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence If no <code class="option">start-time</code> is specified, the current
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence time minus 1 hour (to allow for clock skew) is used.
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<dt><span class="term">-e <em class="replaceable"><code>end-time</code></em></span></dt>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence Specify the date and time when the generated RRSIG records
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence expire. As with <code class="option">start-time</code>, an absolute
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence time is indicated in YYYYMMDDHHMMSS notation. A time relative
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence to the start time is indicated with +N, which is N seconds from
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence the start time. A time relative to the current time is
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence indicated with now+N. If no <code class="option">end-time</code> is
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence specified, 30 days from the start time is used as a default.
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence <code class="option">end-time</code> must be later than
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<dt><span class="term">-X <em class="replaceable"><code>extended end-time</code></em></span></dt>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence Specify the date and time when the generated RRSIG records
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence for the DNSKEY RRset will expire. This is to be used in cases
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence when the DNSKEY signatures need to persist longer than
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence signatures on other records; e.g., when the private component
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence of the KSK is kept offline and the KSK signature is to be
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence refreshed manually.
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence As with <code class="option">start-time</code>, an absolute
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence time is indicated in YYYYMMDDHHMMSS notation. A time relative
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence to the start time is indicated with +N, which is N seconds from
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence the start time. A time relative to the current time is
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence indicated with now+N. If no <code class="option">extended end-time</code> is
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence specified, the value of <code class="option">end-time</code> is used as
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence the default. (<code class="option">end-time</code>, in turn, defaults to
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence 30 days from the start time.) <code class="option">extended end-time</code>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence must be later than <code class="option">start-time</code>.
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<dt><span class="term">-f <em class="replaceable"><code>output-file</code></em></span></dt>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence The name of the output file containing the signed zone. The
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence default is to append <code class="filename">.signed</code> to
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence the input filename. If <code class="option">output-file</code> is
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence set to <code class="literal">"-"</code>, then the signed zone is
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence written to the standard output, with a default output
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence format of "full".
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence Prints a short summary of the options and arguments to
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence <span><strong class="command">dnssec-signzone</strong></span>.
4b598d8ae578861d5f3fc1333c9f84c9c9c8be7cDavid Lawrence Prints version information.
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<dt><span class="term">-i <em class="replaceable"><code>interval</code></em></span></dt>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence When a previously-signed zone is passed as input, records
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence may be resigned. The <code class="option">interval</code> option
5a6e6c2c9b2f6cf426aa2a682aa800765e26d540Andreas Gustafsson specifies the cycle interval as an offset from the current
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence time (in seconds). If a RRSIG record expires after the
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence cycle interval, it is retained. Otherwise, it is considered
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence to be expiring soon, and it will be replaced.
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence The default cycle interval is one quarter of the difference
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence between the signature end and start times. So if neither
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence <code class="option">end-time</code> or <code class="option">start-time</code>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence are specified, <span><strong class="command">dnssec-signzone</strong></span>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence signatures that are valid for 30 days, with a cycle
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence interval of 7.5 days. Therefore, if any existing RRSIG records
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence are due to expire in less than 7.5 days, they would be
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<dt><span class="term">-I <em class="replaceable"><code>input-format</code></em></span></dt>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence The format of the input zone file.
5a6e6c2c9b2f6cf426aa2a682aa800765e26d540Andreas Gustafsson Possible formats are <span><strong class="command">"text"</strong></span> (default),
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence <span><strong class="command">"raw"</strong></span>, and <span><strong class="command">"map"</strong></span>.
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence This option is primarily intended to be used for dynamic
541ed6feaf687e97990ad19748faeec744158559David Lawrence signed zones so that the dumped zone file in a non-text
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence format containing updates can be signed directly.
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence The use of this option does not make much sense for
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence non-dynamic zones.
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<dt><span class="term">-j <em class="replaceable"><code>jitter</code></em></span></dt>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence When signing a zone with a fixed signature lifetime, all
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence RRSIG records issued at the time of signing expires
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence simultaneously. If the zone is incrementally signed, i.e.
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence a previously-signed zone is passed as input to the signer,
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence all expired signatures have to be regenerated at about the
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence same time. The <code class="option">jitter</code> option specifies a
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence jitter window that will be used to randomize the signature
541ed6feaf687e97990ad19748faeec744158559David Lawrence expire time, thus spreading incremental signature
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence regeneration over time.
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence Signature lifetime jitter also to some extent benefits
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence validators and servers by spreading out cache expiration,
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence i.e. if large numbers of RRSIGs don't expire at the same time
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence from all caches there will be less congestion than if all
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence validators need to refetch at mostly the same time.
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<dt><span class="term">-L <em class="replaceable"><code>serial</code></em></span></dt>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence When writing a signed zone to "raw" or "map" format, set the
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence "source serial" value in the header to the specified serial
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence number. (This is expected to be used primarily for testing
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<dt><span class="term">-n <em class="replaceable"><code>ncpus</code></em></span></dt>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence Specifies the number of threads to use. By default, one
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence thread is started for each detected CPU.
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<dt><span class="term">-N <em class="replaceable"><code>soa-serial-format</code></em></span></dt>
541ed6feaf687e97990ad19748faeec744158559David Lawrence The SOA serial number format of the signed zone.
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence Possible formats are <span><strong class="command">"keep"</strong></span> (default),
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence <span><strong class="command">"increment"</strong></span>, <span><strong class="command">"unixtime"</strong></span>,
541ed6feaf687e97990ad19748faeec744158559David Lawrence and <span><strong class="command">"date"</strong></span>.
541ed6feaf687e97990ad19748faeec744158559David Lawrence<dt><span class="term"><span><strong class="command">"keep"</strong></span></span></dt>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<dd><p>Do not modify the SOA serial number.</p></dd>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<dt><span class="term"><span><strong class="command">"increment"</strong></span></span></dt>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<dd><p>Increment the SOA serial number using RFC 1982
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<dt><span class="term"><span><strong class="command">"unixtime"</strong></span></span></dt>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<dd><p>Set the SOA serial number to the number of seconds
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<dt><span class="term"><span><strong class="command">"date"</strong></span></span></dt>
f4a7d04843eb62c92f2d4ff338da49ae86e3279bDavid Lawrence<dd><p>Set the SOA serial number to today's date in
and <span><strong class="command">"map"</strong></span>, <span><strong class="command">"raw"</strong></span>,
Kexample.com.+003+17247