man.ddns-confgen.html revision 7911e6f9de303bca5a3d8b34f4330c8f7cecffae
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - Copyright (C) 2000-2016 Internet Systems Consortium, Inc. ("ISC")
4a14ce5ba00ab7bc55c99ffdcf59c7a4ab902721Automatic Updater - This Source Code Form is subject to the terms of the Mozilla Public
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - License, v. 2.0. If a copy of the MPL was not distributed with this
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - file, You can obtain one at http://mozilla.org/MPL/2.0/.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<link rel="home" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<link rel="up" href="Bv9ARM.ch13.html" title="Manual pages">
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<link rel="prev" href="man.rndc-confgen.html" title="rndc-confgen">
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<link rel="next" href="man.arpaname.html" title="arpaname">
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<table width="100%" summary="Navigation header">
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<tr><th colspan="3" align="center"><span class="application">ddns-confgen</span></th></tr>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<a accesskey="p" href="man.rndc-confgen.html">Prev</a>�</td>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<th width="60%" align="center">Manual pages</th>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<td width="20%" align="right">�<a accesskey="n" href="man.arpaname.html">Next</a>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<a name="man.ddns-confgen"></a><div class="titlepage"></div>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <span class="application">ddns-confgen</span>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews — ddns key generation tool
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews [<code class="option">-a <em class="replaceable"><code>algorithm</code></em></code>]
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews [<code class="option">-r <em class="replaceable"><code>randomfile</code></em></code>]
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews [<code class="option">-a <em class="replaceable"><code>algorithm</code></em></code>]
b2f07642fd712c8fda81a116bcdde229ab291f33Tinderbox User [<code class="option">-k <em class="replaceable"><code>keyname</code></em></code>]
b2f07642fd712c8fda81a116bcdde229ab291f33Tinderbox User [<code class="option">-r <em class="replaceable"><code>randomfile</code></em></code>]
b2f07642fd712c8fda81a116bcdde229ab291f33Tinderbox User -s <em class="replaceable"><code>name</code></em>
b2f07642fd712c8fda81a116bcdde229ab291f33Tinderbox User | -z <em class="replaceable"><code>zone</code></em>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <span class="command"><strong>tsig-keygen</strong></span> and <span class="command"><strong>ddns-confgen</strong></span>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews are invocation methods for a utility that generates keys for use
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews in TSIG signing. The resulting keys can be used, for example,
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews to secure dynamic DNS updates to a zone or for the
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <span class="command"><strong>rndc</strong></span> command channel.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews When run as <span class="command"><strong>tsig-keygen</strong></span>, a domain name
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User can be specified on the command line which will be used as
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User the name of the generated key. If no name is specified,
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User the default is <code class="constant">tsig-key</code>.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews When run as <span class="command"><strong>ddns-confgen</strong></span>, the generated
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User key is accompanied by configuration text and instructions
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User that can be used with <span class="command"><strong>nsupdate</strong></span> and
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User <span class="command"><strong>named</strong></span> when setting up dynamic DNS,
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User including an example <span class="command"><strong>update-policy</strong></span>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User statement. (This usage similar to the
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <span class="command"><strong>rndc-confgen</strong></span> command for setting
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User up command channel security.)
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User Note that <span class="command"><strong>named</strong></span> itself can configure a
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User local DDNS key for use with <span class="command"><strong>nsupdate -l</strong></span>:
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User it does this when a zone is configured with
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User <span class="command"><strong>update-policy local;</strong></span>.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <span class="command"><strong>ddns-confgen</strong></span> is only needed when a
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews more elaborate configuration is required: for instance,
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User if <span class="command"><strong>nsupdate</strong></span> is to be used from a remote
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <div class="variablelist"><dl class="variablelist">
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User<dt><span class="term">-a <em class="replaceable"><code>algorithm</code></em></span></dt>
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User Specifies the algorithm to use for the TSIG key. Available
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User choices are: hmac-md5, hmac-sha1, hmac-sha224, hmac-sha256,
d3ddafd7469d1f3430ccd1b0fe0d13ccbbaf5debTinderbox User hmac-sha384 and hmac-sha512. The default is hmac-sha256.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Options are case-insensitive, and the "hmac-" prefix
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User may be omitted.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Prints a short summary of options and arguments.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<dt><span class="term">-k <em class="replaceable"><code>keyname</code></em></span></dt>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Specifies the key name of the DDNS authentication key.
c247e3f281613fabe1af362e9f3157e35ebbe52cMark Andrews The default is <code class="constant">ddns-key</code> when neither
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User the <code class="option">-s</code> nor <code class="option">-z</code> option is
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User specified; otherwise, the default
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User is <code class="constant">ddns-key</code> as a separate label
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User followed by the argument of the option, e.g.,
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User <code class="constant">ddns-key.example.com.</code>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt The key name must have the format of a valid domain name,
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User consisting of letters, digits, hyphens and periods.
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User (<span class="command"><strong>ddns-confgen</strong></span> only.) Quiet mode: Print
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User only the key, with no explanatory text or usage examples;
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User This is essentially identical to <span class="command"><strong>tsig-keygen</strong></span>.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<dt><span class="term">-r <em class="replaceable"><code>randomfile</code></em></span></dt>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Specifies a source of random data for generating the
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User authorization. If the operating system does not provide a
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <code class="filename">/dev/random</code> or equivalent device, the
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt default source of randomness is keyboard input.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <code class="filename">randomdev</code> specifies the name of a
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User character device or file containing random data to be used
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User instead of the default. The special value
0ccb0e98c77a9b9636a036f8f64f5679a430aaf4Tinderbox User <code class="filename">keyboard</code> indicates that keyboard input
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User should be used.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<dt><span class="term">-s <em class="replaceable"><code>name</code></em></span></dt>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt (<span class="command"><strong>ddns-confgen</strong></span> only.)
395c95214142142854509945adf3293c0270e1c5Tinderbox User Generate configuration example to allow dynamic updates
395c95214142142854509945adf3293c0270e1c5Tinderbox User of a single hostname. The example <span class="command"><strong>named.conf</strong></span>
395c95214142142854509945adf3293c0270e1c5Tinderbox User text shows how to set an update policy for the specified
395c95214142142854509945adf3293c0270e1c5Tinderbox User <em class="replaceable"><code>name</code></em>
395c95214142142854509945adf3293c0270e1c5Tinderbox User using the "name" nametype. The default key name is
395c95214142142854509945adf3293c0270e1c5Tinderbox User ddns-key.<em class="replaceable"><code>name</code></em>.
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User Note that the "self" nametype cannot be used, since
395c95214142142854509945adf3293c0270e1c5Tinderbox User the name to be updated may differ from the key name.
395c95214142142854509945adf3293c0270e1c5Tinderbox User This option cannot be used with the <code class="option">-z</code> option.
395c95214142142854509945adf3293c0270e1c5Tinderbox User<dt><span class="term">-z <em class="replaceable"><code>zone</code></em></span></dt>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt (<span class="command"><strong>ddns-confgen</strong></span> only.)
395c95214142142854509945adf3293c0270e1c5Tinderbox User Generate configuration example to allow dynamic updates
395c95214142142854509945adf3293c0270e1c5Tinderbox User of a zone: The example <span class="command"><strong>named.conf</strong></span> text
395c95214142142854509945adf3293c0270e1c5Tinderbox User shows how to set an update policy for the specified
395c95214142142854509945adf3293c0270e1c5Tinderbox User <em class="replaceable"><code>zone</code></em>
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User using the "zonesub" nametype, allowing updates to
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt all subdomain names within that
395c95214142142854509945adf3293c0270e1c5Tinderbox User <em class="replaceable"><code>zone</code></em>.
395c95214142142854509945adf3293c0270e1c5Tinderbox User This option cannot be used with the <code class="option">-s</code> option.
395c95214142142854509945adf3293c0270e1c5Tinderbox User <span class="refentrytitle">named.conf</span>(5)
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User <em class="citetitle">BIND 9 Administrator Reference Manual</em>.
395c95214142142854509945adf3293c0270e1c5Tinderbox User<table width="100%" summary="Navigation footer">
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User<a accesskey="p" href="man.rndc-confgen.html">Prev</a>�</td>
395c95214142142854509945adf3293c0270e1c5Tinderbox User<td width="20%" align="center"><a accesskey="u" href="Bv9ARM.ch13.html">Up</a></td>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<td width="40%" align="right">�<a accesskey="n" href="man.arpaname.html">Next</a>
395c95214142142854509945adf3293c0270e1c5Tinderbox User<span class="application">rndc-confgen</span>�</td>
395c95214142142854509945adf3293c0270e1c5Tinderbox User<td width="20%" align="center"><a accesskey="h" href="Bv9ARM.html">Home</a></td>
395c95214142142854509945adf3293c0270e1c5Tinderbox User<td width="40%" align="right" valign="top">�<span class="application">arpaname</span>
76cf91b5df7a1bc450afcb9ce7585c61bb87de68Tinderbox User<p xmlns:db="http://docbook.org/ns/docbook" style="text-align: center;">BIND 9.11.0</p>