man.ddns-confgen.html revision 3c9cf7efb97991f9871bc5633e7ed1cae0932a37
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews - Copyright (C) 2004-2012 Internet Systems Consortium, Inc. ("ISC")
a7c412f37cc73d0332887a746e81220cbf09dd00Mark Andrews - Copyright (C) 2000-2003 Internet Software Consortium.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews - Permission to use, copy, modify, and/or distribute this software for any
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews - purpose with or without fee is hereby granted, provided that the above
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews - copyright notice and this permission notice appear in all copies.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews - PERFORMANCE OF THIS SOFTWARE.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<!-- $Id: man.ddns-confgen.html,v 1.105 2012/01/16 01:14:56 tbox Exp $ -->
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<link rel="up" href="Bv9ARM.ch10.html" title="Manual pages">
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<link rel="prev" href="man.rndc-confgen.html" title="rndc-confgen">
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<link rel="next" href="man.arpaname.html" title="arpaname">
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<table width="100%" summary="Navigation header">
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<tr><th colspan="3" align="center"><span class="application">ddns-confgen</span></th></tr>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<a accesskey="p" href="man.rndc-confgen.html">Prev</a>�</td>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<th width="60%" align="center">Manual pages</th>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<td width="20%" align="right">�<a accesskey="n" href="man.arpaname.html">Next</a>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<a name="man.ddns-confgen"></a><div class="titlepage"></div>
98922b2b2b024dcca25be7c220cf3b16b1e6c4b5Evan Hunt<p><span class="application">ddns-confgen</span> — ddns key generation tool</p>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<div class="cmdsynopsis"><p><code class="command">ddns-confgen</code> [<code class="option">-a <em class="replaceable"><code>algorithm</code></em></code>] [<code class="option">-h</code>] [<code class="option">-k <em class="replaceable"><code>keyname</code></em></code>] [<code class="option">-r <em class="replaceable"><code>randomfile</code></em></code>] [ -s <em class="replaceable"><code>name</code></em> | -z <em class="replaceable"><code>zone</code></em> ] [<code class="option">-q</code>] [name]</p></div>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<p><span><strong class="command">ddns-confgen</strong></span>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews generates a key for use by <span><strong class="command">nsupdate</strong></span>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews and <span><strong class="command">named</strong></span>. It simplifies configuration
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews of dynamic zones by generating a key and providing the
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span><strong class="command">nsupdate</strong></span> and <span><strong class="command">named.conf</strong></span>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews syntax that will be needed to use it, including an example
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span><strong class="command">update-policy</strong></span> statement.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews If a domain name is specified on the command line, it will
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews be used in the name of the generated key and in the sample
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span><strong class="command">named.conf</strong></span> syntax. For example,
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span><strong class="command">ddns-confgen example.com</strong></span> would
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews generate a key called "ddns-key.example.com", and sample
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span><strong class="command">named.conf</strong></span> command that could be used
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews in the zone definition for "example.com".
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Note that <span><strong class="command">named</strong></span> itself can configure a
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews local DDNS key for use with <span><strong class="command">nsupdate -l</strong></span>.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span><strong class="command">ddns-confgen</strong></span> is only needed when a
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews more elaborate configuration is required: for instance, if
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span><strong class="command">nsupdate</strong></span> is to be used from a remote system.
ba751492fcc4f161a18b983d4f018a1a52938cb9Evan Hunt<dt><span class="term">-a <em class="replaceable"><code>algorithm</code></em></span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Specifies the algorithm to use for the TSIG key. Available
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews choices are: hmac-md5, hmac-sha1, hmac-sha224, hmac-sha256,
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews hmac-sha384 and hmac-sha512. The default is hmac-sha256.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Prints a short summary of the options and arguments to
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span><strong class="command">ddns-confgen</strong></span>.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dt><span class="term">-k <em class="replaceable"><code>keyname</code></em></span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Specifies the key name of the DDNS authentication key.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews The default is <code class="constant">ddns-key</code> when neither
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews the <code class="option">-s</code> nor <code class="option">-z</code> option is
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews specified; otherwise, the default
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews is <code class="constant">ddns-key</code> as a separate label
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews followed by the argument of the option, e.g.,
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <code class="constant">ddns-key.example.com.</code>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews The key name must have the format of a valid domain name,
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews consisting of letters, digits, hyphens and periods.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Quiet mode: Print only the key, with no explanatory text or
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews usage examples.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dt><span class="term">-r <em class="replaceable"><code>randomfile</code></em></span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Specifies a source of random data for generating the
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews authorization. If the operating system does not provide a
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <code class="filename">/dev/random</code> or equivalent device, the
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews default source of randomness is keyboard input.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <code class="filename">randomdev</code> specifies the name of a
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews character device or file containing random data to be used
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews instead of the default. The special value
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <code class="filename">keyboard</code> indicates that keyboard input
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews should be used.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dt><span class="term">-s <em class="replaceable"><code>name</code></em></span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Single host mode: The example <span><strong class="command">named.conf</strong></span> text
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews shows how to set an update policy for the specified
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews using the "name" nametype.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews The default key name is
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews ddns-key.<em class="replaceable"><code>name</code></em>.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews Note that the "self" nametype cannot be used, since
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews the name to be updated may differ from the key name.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews This option cannot be used with the <code class="option">-z</code> option.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<dt><span class="term">-z <em class="replaceable"><code>zone</code></em></span></dt>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews zone mode: The example <span><strong class="command">named.conf</strong></span> text
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews shows how to set an update policy for the specified
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews using the "zonesub" nametype, allowing updates to all subdomain
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews names within
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews that <em class="replaceable"><code>zone</code></em>.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews This option cannot be used with the <code class="option">-s</code> option.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<p><span class="citerefentry"><span class="refentrytitle">nsupdate</span>(1)</span>,
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span class="citerefentry"><span class="refentrytitle">named.conf</span>(5)</span>,
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>,
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews <em class="citetitle">BIND 9 Administrator Reference Manual</em>.
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<p><span class="corpauthor">Internet Systems Consortium</span>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<table width="100%" summary="Navigation footer">
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<a accesskey="p" href="man.rndc-confgen.html">Prev</a>�</td>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<td width="20%" align="center"><a accesskey="u" href="Bv9ARM.ch10.html">Up</a></td>
c3c8823fed039b3a2b8e5ca8bc2f3301d1dd840eMark Andrews<td width="40%" align="right">�<a accesskey="n" href="man.arpaname.html">Next</a>
98922b2b2b024dcca25be7c220cf3b16b1e6c4b5Evan Hunt<span class="application">rndc-confgen</span>�</td>
98922b2b2b024dcca25be7c220cf3b16b1e6c4b5Evan Hunt<td width="20%" align="center"><a accesskey="h" href="Bv9ARM.html">Home</a></td>
98922b2b2b024dcca25be7c220cf3b16b1e6c4b5Evan Hunt<td width="40%" align="right" valign="top">�<span class="application">arpaname</span>