man.rndc.html revision 3c7b4ac4517ac9d78c9bf3e0e790cedce10ddc18
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - Copyright (C) 2004-2014 Internet Systems Consortium, Inc. ("ISC")
f0aad5341752aefe5059832f6cf3abc3283c6e16Tinderbox User - Copyright (C) 2000-2003 Internet Software Consortium.
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - Permission to use, copy, modify, and/or distribute this software for any
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - purpose with or without fee is hereby granted, provided that the above
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - copyright notice and this permission notice appear in all copies.
d6fa26d0adaec6c910115be34fe7a5a5f402c14fMark Andrews - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - PERFORMANCE OF THIS SOFTWARE.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<!-- $Id$ -->
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
71c66a876ecca77923638d3f94cc0783152b2f03Mark Andrews<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<link rel="up" href="Bv9ARM.ch10.html" title="Manual pages">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<link rel="prev" href="man.nsupdate.html" title="nsupdate">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<link rel="next" href="man.rndc.conf.html" title="rndc.conf">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<tr><th colspan="3" align="center"><span class="application">rndc</span></th></tr>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<a accesskey="p" href="man.nsupdate.html">Prev</a>�</td>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<th width="60%" align="center">Manual pages</th>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<td width="20%" align="right">�<a accesskey="n" href="man.rndc.conf.html">Next</a>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<a name="man.rndc"></a><div class="titlepage"></div>
af40ebed6257e4ac1996144530b3de317cf4da11Tinderbox User<p><span class="application">rndc</span> — name server control utility</p>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<div class="cmdsynopsis"><p><code class="command">rndc</code> [<code class="option">-b <em class="replaceable"><code>source-address</code></em></code>] [<code class="option">-c <em class="replaceable"><code>config-file</code></em></code>] [<code class="option">-k <em class="replaceable"><code>key-file</code></em></code>] [<code class="option">-s <em class="replaceable"><code>server</code></em></code>] [<code class="option">-p <em class="replaceable"><code>port</code></em></code>] [<code class="option">-q</code>] [<code class="option">-V</code>] [<code class="option">-y <em class="replaceable"><code>key_id</code></em></code>] {command}</p></div>
af40ebed6257e4ac1996144530b3de317cf4da11Tinderbox User<p><span><strong class="command">rndc</strong></span>
af40ebed6257e4ac1996144530b3de317cf4da11Tinderbox User controls the operation of a name
af40ebed6257e4ac1996144530b3de317cf4da11Tinderbox User server. It supersedes the <span><strong class="command">ndc</strong></span> utility
af40ebed6257e4ac1996144530b3de317cf4da11Tinderbox User that was provided in old BIND releases. If
af40ebed6257e4ac1996144530b3de317cf4da11Tinderbox User <span><strong class="command">rndc</strong></span> is invoked with no command line
af40ebed6257e4ac1996144530b3de317cf4da11Tinderbox User options or arguments, it prints a short summary of the
af40ebed6257e4ac1996144530b3de317cf4da11Tinderbox User supported commands and the available options and their
af40ebed6257e4ac1996144530b3de317cf4da11Tinderbox User<p><span><strong class="command">rndc</strong></span>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt communicates with the name server over a TCP connection, sending
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein commands authenticated with digital signatures. In the current
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <span><strong class="command">rndc</strong></span> and <span><strong class="command">named</strong></span>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein the only supported authentication algorithms are HMAC-MD5
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt (for compatibility), HMAC-SHA1, HMAC-SHA224, HMAC-SHA256
af40ebed6257e4ac1996144530b3de317cf4da11Tinderbox User (default), HMAC-SHA384 and HMAC-SHA512.
a1ad6695ed6f988406cf155aa26376f84f73bcb9Automatic Updater They use a shared secret on each end of the connection.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt This provides TSIG-style authentication for the command
af40ebed6257e4ac1996144530b3de317cf4da11Tinderbox User request and the name server's response. All commands sent
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater over the channel must be signed by a key_id known to the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<p><span><strong class="command">rndc</strong></span>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt reads a configuration file to
af40ebed6257e4ac1996144530b3de317cf4da11Tinderbox User determine how to contact the name server and decide what
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt algorithm and key it should use.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<dt><span class="term">-b <em class="replaceable"><code>source-address</code></em></span></dt>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Use <em class="replaceable"><code>source-address</code></em>
af40ebed6257e4ac1996144530b3de317cf4da11Tinderbox User as the source address for the connection to the server.
af40ebed6257e4ac1996144530b3de317cf4da11Tinderbox User Multiple instances are permitted to allow setting of both
af40ebed6257e4ac1996144530b3de317cf4da11Tinderbox User the IPv4 and IPv6 source addresses.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<dt><span class="term">-c <em class="replaceable"><code>config-file</code></em></span></dt>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Use <em class="replaceable"><code>config-file</code></em>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt as the configuration file instead of the default,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term">-k <em class="replaceable"><code>key-file</code></em></span></dt>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Use <em class="replaceable"><code>key-file</code></em>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User as the key file instead of the default,
71c66a876ecca77923638d3f94cc0783152b2f03Mark Andrews <code class="filename">/etc/rndc.key</code>. The key in
71c66a876ecca77923638d3f94cc0783152b2f03Mark Andrews <code class="filename">/etc/rndc.key</code> will be used to
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein authenticate
71c66a876ecca77923638d3f94cc0783152b2f03Mark Andrews commands sent to the server if the <em class="replaceable"><code>config-file</code></em>
71c66a876ecca77923638d3f94cc0783152b2f03Mark Andrews does not exist.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term">-s <em class="replaceable"><code>server</code></em></span></dt>
71c66a876ecca77923638d3f94cc0783152b2f03Mark Andrews<dd><p><em class="replaceable"><code>server</code></em> is
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein the name or address of the server which matches a
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User server statement in the configuration file for
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span><strong class="command">rndc</strong></span>. If no server is supplied on the
71c66a876ecca77923638d3f94cc0783152b2f03Mark Andrews command line, the host named by the default-server clause
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein in the options statement of the <span><strong class="command">rndc</strong></span>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein configuration file will be used.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term">-p <em class="replaceable"><code>port</code></em></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Send commands to TCP port
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User of BIND 9's default control channel port, 953.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Quiet mode: Message text returned by the server
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User will not be printed except when there is an error.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Enable verbose logging.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term">-y <em class="replaceable"><code>key_id</code></em></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Use the key <em class="replaceable"><code>key_id</code></em>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein from the configuration file.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <em class="replaceable"><code>key_id</code></em>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein known by named with the same algorithm and secret string
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein in order for control message validation to succeed.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein If no <em class="replaceable"><code>key_id</code></em>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt is specified, <span><strong class="command">rndc</strong></span> will first look
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein for a key clause in the server statement of the server
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein being used, or if no server statement is present for that
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein host, then the default-key clause of the options statement.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Note that the configuration file contains shared secrets
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein which are used to send authenticated control commands
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein to name servers. It should therefore not have general read
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein or write access.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein A list of commands supported by <span><strong class="command">rndc</strong></span> can
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein be seen by running <span><strong class="command">rndc</strong></span> without arguments.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Currently supported commands are:
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<dt><span class="term"><strong class="userinput"><code>reload</code></strong></span></dt>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews Reload configuration file and zones.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<dt><span class="term"><strong class="userinput"><code>reload <em class="replaceable"><code>zone</code></em> [<span class="optional"><em class="replaceable"><code>class</code></em> [<span class="optional"><em class="replaceable"><code>view</code></em></span>]</span>]</code></strong></span></dt>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews Reload the given zone.
b05bdb520d83f7ecaad708fe305268c3420be01dMark Andrews<dt><span class="term"><strong class="userinput"><code>refresh <em class="replaceable"><code>zone</code></em> [<span class="optional"><em class="replaceable"><code>class</code></em> [<span class="optional"><em class="replaceable"><code>view</code></em></span>]</span>]</code></strong></span></dt>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews Schedule zone maintenance for the given zone.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<dt><span class="term"><strong class="userinput"><code>retransfer <em class="replaceable"><code>zone</code></em> [<span class="optional"><em class="replaceable"><code>class</code></em> [<span class="optional"><em class="replaceable"><code>view</code></em></span>]</span>]</code></strong></span></dt>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews Retransfer the given slave zone from the master server.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein If the zone is configured to use
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">inline-signing</strong></span>, the signed
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein version of the zone is discarded; after the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein retransfer of the unsigned version is complete, the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein signed version will be regenerated with all new
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><strong class="userinput"><code>sign <em class="replaceable"><code>zone</code></em> [<span class="optional"><em class="replaceable"><code>class</code></em> [<span class="optional"><em class="replaceable"><code>view</code></em></span>]</span>]</code></strong></span></dt>
afb33f777af856f8c3382604a7a8ffdfe2b512c5Automatic Updater Fetch all DNSSEC keys for the given zone
afb33f777af856f8c3382604a7a8ffdfe2b512c5Automatic Updater from the key directory (see the
afb33f777af856f8c3382604a7a8ffdfe2b512c5Automatic Updater <span><strong class="command">key-directory</strong></span> option in
afb33f777af856f8c3382604a7a8ffdfe2b512c5Automatic Updater the BIND 9 Administrator Reference Manual). If they are within
afb33f777af856f8c3382604a7a8ffdfe2b512c5Automatic Updater their publication period, merge them into the
afb33f777af856f8c3382604a7a8ffdfe2b512c5Automatic Updater zone's DNSKEY RRset. If the DNSKEY RRset
afb33f777af856f8c3382604a7a8ffdfe2b512c5Automatic Updater is changed, then the zone is automatically
afb33f777af856f8c3382604a7a8ffdfe2b512c5Automatic Updater re-signed with the new key set.
afb33f777af856f8c3382604a7a8ffdfe2b512c5Automatic Updater This command requires that the
afb33f777af856f8c3382604a7a8ffdfe2b512c5Automatic Updater <span><strong class="command">auto-dnssec</strong></span> zone option be set
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein and also requires the zone to be configured to
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein allow dynamic DNS.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein (See "Dynamic Update Policies" in the Administrator
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Reference Manual for more details.)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><strong class="userinput"><code>loadkeys <em class="replaceable"><code>zone</code></em> [<span class="optional"><em class="replaceable"><code>class</code></em> [<span class="optional"><em class="replaceable"><code>view</code></em></span>]</span>]</code></strong></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Fetch all DNSSEC keys for the given zone
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein from the key directory. If they are within
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein their publication period, merge them into the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein zone's DNSKEY RRset. Unlike <span><strong class="command">rndc
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein immediately re-signed by the new keys, but is
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein allowed to incrementally re-sign over time.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein This command requires that the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">auto-dnssec</strong></span> zone option
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein be set to <code class="literal">maintain</code>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein and also requires the zone to be configured to
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein allow dynamic DNS.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein (See "Dynamic Update Policies" in the Administrator
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Reference Manual for more details.)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><strong class="userinput"><code>freeze [<span class="optional"><em class="replaceable"><code>zone</code></em> [<span class="optional"><em class="replaceable"><code>class</code></em> [<span class="optional"><em class="replaceable"><code>view</code></em></span>]</span>]</span>]</code></strong></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Suspend updates to a dynamic zone. If no zone is
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein specified, then all zones are suspended. This allows
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein manual edits to be made to a zone normally updated by
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein dynamic update. It also causes changes in the
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt journal file to be synced into the master file.
ceeb18e6907a10547859faa340ecad83bedae90cMark Andrews All dynamic update attempts will be refused while
ceeb18e6907a10547859faa340ecad83bedae90cMark Andrews the zone is frozen.
ceeb18e6907a10547859faa340ecad83bedae90cMark Andrews<dt><span class="term"><strong class="userinput"><code>thaw [<span class="optional"><em class="replaceable"><code>zone</code></em> [<span class="optional"><em class="replaceable"><code>class</code></em> [<span class="optional"><em class="replaceable"><code>view</code></em></span>]</span>]</span>]</code></strong></span></dt>
ceeb18e6907a10547859faa340ecad83bedae90cMark Andrews Enable updates to a frozen dynamic zone. If no
ceeb18e6907a10547859faa340ecad83bedae90cMark Andrews zone is specified, then all frozen zones are
ceeb18e6907a10547859faa340ecad83bedae90cMark Andrews enabled. This causes the server to reload the zone
ceeb18e6907a10547859faa340ecad83bedae90cMark Andrews from disk, and re-enables dynamic updates after the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein load has completed. After a zone is thawed,
ceeb18e6907a10547859faa340ecad83bedae90cMark Andrews dynamic updates will no longer be refused. If
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt the zone has changed and the
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <span><strong class="command">ixfr-from-differences</strong></span> option is
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt in use, then the journal file will be updated to
ceeb18e6907a10547859faa340ecad83bedae90cMark Andrews reflect changes in the zone. Otherwise, if the
ceeb18e6907a10547859faa340ecad83bedae90cMark Andrews zone has changed, any existing journal file will be
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><strong class="userinput"><code>scan</code></strong></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Scan the list of available network interfaces
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein for changes, without performing a full
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">reconfig</strong></span> or waiting for the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">interface-interval</strong></span> timer.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><strong class="userinput"><code>sync [<span class="optional">-clean</span>] [<span class="optional"><em class="replaceable"><code>zone</code></em> [<span class="optional"><em class="replaceable"><code>class</code></em> [<span class="optional"><em class="replaceable"><code>view</code></em></span>]</span>]</span>]</code></strong></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Sync changes in the journal file for a dynamic zone
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein to the master file. If the "-clean" option is
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein specified, the journal file is also removed. If
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein no zone is specified, then all zones are synced.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><strong class="userinput"><code>notify <em class="replaceable"><code>zone</code></em> [<span class="optional"><em class="replaceable"><code>class</code></em> [<span class="optional"><em class="replaceable"><code>view</code></em></span>]</span>]</code></strong></span></dt>
3a32ac2a720653083c7a22cb654b86c398f6d4c8Tinderbox User Resend NOTIFY messages for the zone.
3a32ac2a720653083c7a22cb654b86c398f6d4c8Tinderbox User<dt><span class="term"><strong class="userinput"><code>reconfig</code></strong></span></dt>
3a32ac2a720653083c7a22cb654b86c398f6d4c8Tinderbox User Reload the configuration file and load new zones,
3a32ac2a720653083c7a22cb654b86c398f6d4c8Tinderbox User but do not reload existing zone files even if they
3a32ac2a720653083c7a22cb654b86c398f6d4c8Tinderbox User have changed.
3a32ac2a720653083c7a22cb654b86c398f6d4c8Tinderbox User This is faster than a full <span><strong class="command">reload</strong></span> when there
3a32ac2a720653083c7a22cb654b86c398f6d4c8Tinderbox User is a large number of zones because it avoids the need
3a32ac2a720653083c7a22cb654b86c398f6d4c8Tinderbox User to examine the
3a32ac2a720653083c7a22cb654b86c398f6d4c8Tinderbox User modification times of the zones files.
3a32ac2a720653083c7a22cb654b86c398f6d4c8Tinderbox User<dt><span class="term"><strong class="userinput"><code>zonestatus [<span class="optional"><em class="replaceable"><code>zone</code></em> [<span class="optional"><em class="replaceable"><code>class</code></em> [<span class="optional"><em class="replaceable"><code>view</code></em></span>]</span>]</span>]</code></strong></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Displays the current status of the given zone,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein including the master file name and any include
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein files from which it was loaded, when it was most
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein recently loaded, the current serial number, the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein number of nodes, whether the zone supports
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein dynamic updates, whether the zone is DNSSEC
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein signed, whether it uses automatic DNSSEC key
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein management or inline signing, and the scheduled
bea931e17b7567f09107f93ab7e25c7f00abeb9cMark Andrews refresh or expiry times for the zone.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><strong class="userinput"><code>stats</code></strong></span></dt>
b05bdb520d83f7ecaad708fe305268c3420be01dMark Andrews Write server statistics to the statistics file.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><strong class="userinput"><code>querylog</code></strong> [<span class="optional">on|off</span>] </span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Enable or disable query logging. (For backward
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein compatibility, this command can also be used without
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein an argument to toggle query logging on and off.)
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Query logging can also be enabled
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein by explicitly directing the <span><strong class="command">queries</strong></span>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">category</strong></span> to a
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">channel</strong></span> in the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">logging</strong></span> section of
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <code class="filename">named.conf</code> or by specifying
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">querylog yes;</strong></span> in the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">options</strong></span> section of
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<dt><span class="term"><strong class="userinput"><code>dumpdb [<span class="optional">-all|-cache|-zone</span>] [<span class="optional"><em class="replaceable"><code>view ...</code></em></span>]</code></strong></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Dump the server's caches (default) and/or zones to
ceeb18e6907a10547859faa340ecad83bedae90cMark Andrews dump file for the specified views. If no view is
ceeb18e6907a10547859faa340ecad83bedae90cMark Andrews specified, all
ceeb18e6907a10547859faa340ecad83bedae90cMark Andrews views are dumped.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><strong class="userinput"><code>secroots [<span class="optional"><em class="replaceable"><code>view ...</code></em></span>]</code></strong></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Dump the server's security roots to the secroots
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein file for the specified views. If no view is
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein specified, security roots for all
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein views are dumped.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><strong class="userinput"><code>stop [<span class="optional">-p</span>]</code></strong></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Stop the server, making sure any recent changes
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein made through dynamic update or IXFR are first saved to
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein the master files of the updated zones.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein If <code class="option">-p</code> is specified <span><strong class="command">named</strong></span>'s process id is returned.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein This allows an external process to determine when <span><strong class="command">named</strong></span>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein had completed stopping.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><strong class="userinput"><code>halt [<span class="optional">-p</span>]</code></strong></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Stop the server immediately. Recent changes
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein made through dynamic update or IXFR are not saved to
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein the master files, but will be rolled forward from the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein journal files when the server is restarted.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein If <code class="option">-p</code> is specified <span><strong class="command">named</strong></span>'s process id is returned.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein This allows an external process to determine when <span><strong class="command">named</strong></span>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein had completed halting.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><strong class="userinput"><code>trace</code></strong></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Increment the servers debugging level by one.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><strong class="userinput"><code>trace <em class="replaceable"><code>level</code></em></code></strong></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Sets the server's debugging level to an explicit
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><strong class="userinput"><code>notrace</code></strong></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Sets the server's debugging level to 0.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><strong class="userinput"><code>flush</code></strong></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Flushes the server's cache.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><strong class="userinput"><code>flushname</code></strong> <em class="replaceable"><code>name</code></em> [<span class="optional"><em class="replaceable"><code>view</code></em></span>] </span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Flushes the given name from the server's DNS cache
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein and, if applicable, from the server's nameserver address
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein database or bad-server cache.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><strong class="userinput"><code>flushtree</code></strong> [<span class="optional">-all</span>] <em class="replaceable"><code>name</code></em> [<span class="optional"><em class="replaceable"><code>view</code></em></span>] </span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Flushes the given name, and all of its subdomains,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein from the server's DNS cache, the address database,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein and the bad server cache.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><strong class="userinput"><code>status</code></strong></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Display status of the server.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Note that the number of zones includes the internal <span><strong class="command">bind/CH</strong></span> zone
984c2e9f76e66e86f7d9aca99a774836ddf196eaAutomatic Updater and the default <span><strong class="command">/IN</strong></span>
984c2e9f76e66e86f7d9aca99a774836ddf196eaAutomatic Updater hint zone if there is not an
984c2e9f76e66e86f7d9aca99a774836ddf196eaAutomatic Updater explicit root zone configured.
984c2e9f76e66e86f7d9aca99a774836ddf196eaAutomatic Updater<dt><span class="term"><strong class="userinput"><code>recursing</code></strong></span></dt>
984c2e9f76e66e86f7d9aca99a774836ddf196eaAutomatic Updater Dump the list of queries <span><strong class="command">named</strong></span> is currently recursing
984c2e9f76e66e86f7d9aca99a774836ddf196eaAutomatic Updater<dt><span class="term"><strong class="userinput"><code>validation ( on | off | check ) [<span class="optional"><em class="replaceable"><code>view ...</code></em></span>] </code></strong></span></dt>
984c2e9f76e66e86f7d9aca99a774836ddf196eaAutomatic Updater Enable, disable, or check the current status of
984c2e9f76e66e86f7d9aca99a774836ddf196eaAutomatic Updater DNSSEC validation.
984c2e9f76e66e86f7d9aca99a774836ddf196eaAutomatic Updater Note <span><strong class="command">dnssec-enable</strong></span> also needs to be
984c2e9f76e66e86f7d9aca99a774836ddf196eaAutomatic Updater set to <strong class="userinput"><code>yes</code></strong> or
984c2e9f76e66e86f7d9aca99a774836ddf196eaAutomatic Updater <strong class="userinput"><code>auto</code></strong> to be effective.
984c2e9f76e66e86f7d9aca99a774836ddf196eaAutomatic Updater It defaults to enabled.
984c2e9f76e66e86f7d9aca99a774836ddf196eaAutomatic Updater<dt><span class="term"><strong class="userinput"><code>tsig-list</code></strong></span></dt>
984c2e9f76e66e86f7d9aca99a774836ddf196eaAutomatic Updater List the names of all TSIG keys currently configured
984c2e9f76e66e86f7d9aca99a774836ddf196eaAutomatic Updater for use by <span><strong class="command">named</strong></span> in each view. The
984c2e9f76e66e86f7d9aca99a774836ddf196eaAutomatic Updater list both statically configured keys and dynamic
984c2e9f76e66e86f7d9aca99a774836ddf196eaAutomatic Updater TKEY-negotiated keys.
984c2e9f76e66e86f7d9aca99a774836ddf196eaAutomatic Updater<dt><span class="term"><strong class="userinput"><code>tsig-delete</code></strong> <em class="replaceable"><code>keyname</code></em> [<span class="optional"><em class="replaceable"><code>view</code></em></span>]</span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Delete a given TKEY-negotiated key from the server.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein (This does not apply to statically configured TSIG
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term"><strong class="userinput"><code>addzone <em class="replaceable"><code>zone</code></em> [<span class="optional"><em class="replaceable"><code>class</code></em> [<span class="optional"><em class="replaceable"><code>view</code></em></span>]</span>] <em class="replaceable"><code>configuration</code></em> </code></strong></span></dt>
dad65f7c93330a10705384739dff3a6d4dfe1e70Tinderbox User Add a zone while the server is running. This
dad65f7c93330a10705384739dff3a6d4dfe1e70Tinderbox User command requires the
dad65f7c93330a10705384739dff3a6d4dfe1e70Tinderbox User <span><strong class="command">allow-new-zones</strong></span> option to be set
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein to <strong class="userinput"><code>yes</code></strong>. The
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <em class="replaceable"><code>configuration</code></em> string
dad65f7c93330a10705384739dff3a6d4dfe1e70Tinderbox User specified on the command line is the zone
dad65f7c93330a10705384739dff3a6d4dfe1e70Tinderbox User configuration text that would ordinarily be
bae169ea64bf736d6ea6074c2af3d7c117079972Tinderbox User placed in <code class="filename">named.conf</code>.
bae169ea64bf736d6ea6074c2af3d7c117079972Tinderbox User The configuration is saved in a file called
bae169ea64bf736d6ea6074c2af3d7c117079972Tinderbox User <code class="filename"><em class="replaceable"><code>hash</code></em>.nzf</code>,
bae169ea64bf736d6ea6074c2af3d7c117079972Tinderbox User where <em class="replaceable"><code>hash</code></em> is a
a24330c4805a224191ab687d0291963062fe3355Tinderbox User cryptographic hash generated from the name of
bae169ea64bf736d6ea6074c2af3d7c117079972Tinderbox User the view. When <span><strong class="command">named</strong></span> is
5d564da348e890e42f63eebf2dced9a05b41f4fbTinderbox User restarted, the file will be loaded into the view
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein configuration, so that zones that were added
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein can persist after a restart.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews This sample <span><strong class="command">addzone</strong></span> command
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews would add the zone <code class="literal">example.com</code>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews to the default view:
dad65f7c93330a10705384739dff3a6d4dfe1e70Tinderbox User<code class="prompt">$ </code><strong class="userinput"><code>rndc addzone example.com '{ type master; file "example.com.db"; };'</code></strong>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein (Note the brackets and semi-colon around the zone
dad65f7c93330a10705384739dff3a6d4dfe1e70Tinderbox User configuration text.)
dad65f7c93330a10705384739dff3a6d4dfe1e70Tinderbox User<dt><span class="term"><strong class="userinput"><code>delzone [<span class="optional">-clean</span>] <em class="replaceable"><code>zone</code></em> [<span class="optional"><em class="replaceable"><code>class</code></em> [<span class="optional"><em class="replaceable"><code>view</code></em></span>]</span>] </code></strong></span></dt>
dad65f7c93330a10705384739dff3a6d4dfe1e70Tinderbox User Delete a zone while the server is running.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Only zones that were originally added via
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">rndc addzone</strong></span> can be deleted
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein in this manner.
8f70b6b48364b58f2823e735c35bf77787de0860Tinderbox User If the <code class="option">-clean</code> is specified,
8f70b6b48364b58f2823e735c35bf77787de0860Tinderbox User the zone's master file (and journal file, if any)
8f70b6b48364b58f2823e735c35bf77787de0860Tinderbox User will be deleted along with the zone. Without the
8f70b6b48364b58f2823e735c35bf77787de0860Tinderbox User <code class="option">-clean</code> option, zone files must
8f70b6b48364b58f2823e735c35bf77787de0860Tinderbox User be cleaned up by hand. (If the zone is of
8f70b6b48364b58f2823e735c35bf77787de0860Tinderbox User type "slave" or "stub", the files needing to
8f70b6b48364b58f2823e735c35bf77787de0860Tinderbox User be cleaned up will be reported in the output
8f70b6b48364b58f2823e735c35bf77787de0860Tinderbox User of the <span><strong class="command">rndc delzone</strong></span> command.)
dec590a3deb8e87380a8bd3a77d535dba3729bf6Tinderbox User<dt><span class="term"><strong class="userinput"><code>signing [<span class="optional">( -list | -clear <em class="replaceable"><code>keyid/algorithm</code></em> | -clear <code class="literal">all</code> | -nsec3param ( <em class="replaceable"><code>parameters</code></em> | <code class="literal">none</code> ) ) </span>] <em class="replaceable"><code>zone</code></em> [<span class="optional"><em class="replaceable"><code>class</code></em> [<span class="optional"><em class="replaceable"><code>view</code></em></span>]</span>] </code></strong></span></dt>
8f70b6b48364b58f2823e735c35bf77787de0860Tinderbox User List, edit, or remove the DNSSEC signing state records
8f70b6b48364b58f2823e735c35bf77787de0860Tinderbox User for the specified zone. The status of ongoing DNSSEC
8f70b6b48364b58f2823e735c35bf77787de0860Tinderbox User operations (such as signing or generating
8f70b6b48364b58f2823e735c35bf77787de0860Tinderbox User NSEC3 chains) is stored in the zone in the form
8f70b6b48364b58f2823e735c35bf77787de0860Tinderbox User of DNS resource records of type
8f70b6b48364b58f2823e735c35bf77787de0860Tinderbox User <span><strong class="command">sig-signing-type</strong></span>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">rndc signing -list</strong></span> converts
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein these records into a human-readable form,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein indicating which keys are currently signing
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein or have finished signing the zone, and which NSEC3
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein chains are being created or removed.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">rndc signing -clear</strong></span> can remove
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein a single key (specified in the same format that
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">rndc signing -list</strong></span> uses to
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein display it), or all keys. In either case, only
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein completed keys are removed; any record indicating
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein that a key has not yet finished signing the zone
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein will be retained.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">rndc signing -nsec3param</strong></span> sets
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein the NSEC3 parameters for a zone. This is the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein only supported mechanism for using NSEC3 with
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">inline-signing</strong></span> zones.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Parameters are specified in the same format as
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein an NSEC3PARAM resource record: hash algorithm,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein flags, iterations, and salt, in that order.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Currently, the only defined value for hash algorithm
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein is <code class="literal">1</code>, representing SHA-1.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein The <code class="option">flags</code> may be set to
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <code class="literal">0</code> or <code class="literal">1</code>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein depending on whether you wish to set the opt-out
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein bit in the NSEC3 chain. <code class="option">iterations</code>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein defines the number of additional times to apply
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein the algorithm when generating an NSEC3 hash. The
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <code class="option">salt</code> is a string of data expressed
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User in hexadecimal, a hyphen (`-') if no salt is
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User to be used, or the keyword <code class="literal">auto</code>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein which causes <span><strong class="command">named</strong></span> to generate a
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein random 64-bit salt.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein So, for example, to create an NSEC3 chain using
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User the SHA-1 hash algorithm, no opt-out flag,
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User 10 iterations, and a salt value of "FFFF", use:
a9ba09c109ec7a7dd0523efb1bbd51e210fed8d6Tinderbox User <span><strong class="command">rndc signing -nsec3param 1 0 10 FFFF <em class="replaceable"><code>zone</code></em></strong></span>.
a9ba09c109ec7a7dd0523efb1bbd51e210fed8d6Tinderbox User To set the opt-out flag, 15 iterations, and no
a9ba09c109ec7a7dd0523efb1bbd51e210fed8d6Tinderbox User <span><strong class="command">rndc signing -nsec3param 1 1 15 - <em class="replaceable"><code>zone</code></em></strong></span>.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span><strong class="command">rndc signing -nsec3param none</strong></span>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User removes an existing NSEC3 chain and replaces it
4556ad3a270bf049b3225433a402666aaffe3c36Mark Andrews There is currently no way to provide the shared secret for a
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <code class="option">key_id</code> without using the configuration file.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Several error messages could be clearer.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<p><span class="citerefentry"><span class="refentrytitle">rndc.conf</span>(5)</span>,
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span class="citerefentry"><span class="refentrytitle">rndc-confgen</span>(8)</span>,
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span class="citerefentry"><span class="refentrytitle">named.conf</span>(5)</span>,
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span class="citerefentry"><span class="refentrytitle">ndc</span>(8)</span>,
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <em class="citetitle">BIND 9 Administrator Reference Manual</em>.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<p><span class="corpauthor">Internet Systems Consortium</span>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<table width="100%" summary="Navigation footer">
4556ad3a270bf049b3225433a402666aaffe3c36Mark Andrews<a accesskey="p" href="man.nsupdate.html">Prev</a>�</td>
4556ad3a270bf049b3225433a402666aaffe3c36Mark Andrews<td width="20%" align="center"><a accesskey="u" href="Bv9ARM.ch10.html">Up</a></td>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<td width="40%" align="right">�<a accesskey="n" href="man.rndc.conf.html">Next</a>
4556ad3a270bf049b3225433a402666aaffe3c36Mark Andrews<td width="20%" align="center"><a accesskey="h" href="Bv9ARM.html">Home</a></td>
4556ad3a270bf049b3225433a402666aaffe3c36Mark Andrews<td width="40%" align="right" valign="top">�<code class="filename">rndc.conf</code>