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