man.ddns-confgen.html revision d2ebd5d5fba00a44ca49462c6cd4390e9876a137
c92c50783e4e93699f2a42643b8f200b9b719c87Automatic Updater - Copyright (C) 2004-2009 Internet Systems Consortium, Inc. ("ISC")
75c0816e8295e180f4bc7f10db3d0d880383bc1cMark Andrews - Copyright (C) 2000-2003 Internet Software Consortium.
4a14ce5ba00ab7bc55c99ffdcf59c7a4ab902721Automatic Updater - Permission to use, copy, modify, and/or distribute this software for any
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - purpose with or without fee is hereby granted, provided that the above
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - copyright notice and this permission notice appear in all copies.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - 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
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein - PERFORMANCE OF THIS SOFTWARE.
ea94d370123a5892f6c47a97f21d1b28d44bb168Tinderbox User<!-- $Id: man.ddns-confgen.html,v 1.20 2009/09/19 01:14:52 tbox Exp $ -->
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
e21a2904f02a03fa06b6db04d348f65fe9c67b2bMark 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.rndc-confgen.html" title="rndc-confgen">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<tr><th colspan="3" align="center"><span class="application">ddns-confgen</span></th></tr>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<a accesskey="p" href="man.rndc-confgen.html">Prev</a>�</td>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<a name="man.ddns-confgen"></a><div class="titlepage"></div>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<p><span class="application">ddns-confgen</span> — ddns key generation tool</p>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<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>
9941177e7eb530451d5970959cc2828c53cb36c9Tinderbox User<p><span><strong class="command">ddns-confgen</strong></span>
9941177e7eb530451d5970959cc2828c53cb36c9Tinderbox User generates a key for use by <span><strong class="command">nsupdate</strong></span>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein and <span><strong class="command">named</strong></span>. It simplifies configuration
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein of dynamic zones by generating a key and providing the
9941177e7eb530451d5970959cc2828c53cb36c9Tinderbox User <span><strong class="command">nsupdate</strong></span> and <span><strong class="command">named.conf</strong></span>
9941177e7eb530451d5970959cc2828c53cb36c9Tinderbox User syntax that will be needed to use it, including an example
9941177e7eb530451d5970959cc2828c53cb36c9Tinderbox User <span><strong class="command">update-policy</strong></span> statement.
9941177e7eb530451d5970959cc2828c53cb36c9Tinderbox User If a domain name is specified on the command line, it will
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein be used in the name of the generated key and in the sample
9941177e7eb530451d5970959cc2828c53cb36c9Tinderbox User <span><strong class="command">named.conf</strong></span> syntax. For example,
9941177e7eb530451d5970959cc2828c53cb36c9Tinderbox User <span><strong class="command">ddns-confgen example.com</strong></span> would
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein generate a key called "ddns-key.example.com", and sample
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span><strong class="command">named.conf</strong></span> command that could be used
9941177e7eb530451d5970959cc2828c53cb36c9Tinderbox User in the zone definition for "example.com".
44d0f0256fbdce130a18655023c3b06bacacbd61Automatic Updater Note that <span><strong class="command">named</strong></span> itself can configure a
6f64d4ab8e68f9b2333bcbfc755396d29a4a9d7cAutomatic Updater local DDNS key for use with <span><strong class="command">nsupdate -l</strong></span>.
6f64d4ab8e68f9b2333bcbfc755396d29a4a9d7cAutomatic Updater <span><strong class="command">ddns-confgen</strong></span> is only needed when a
bcf15a19ae0efa72a22cdfb50666a3c6ce39eb9fTinderbox User more elaborate configuration is required: for instance, if
bcf15a19ae0efa72a22cdfb50666a3c6ce39eb9fTinderbox User <span><strong class="command">nsupdate</strong></span> is to be used from a remote system.
bcf15a19ae0efa72a22cdfb50666a3c6ce39eb9fTinderbox User<dt><span class="term">-a <em class="replaceable"><code>algorithm</code></em></span></dt>
bcf15a19ae0efa72a22cdfb50666a3c6ce39eb9fTinderbox User Specifies the algorithm to use for the TSIG key. Available
bcf15a19ae0efa72a22cdfb50666a3c6ce39eb9fTinderbox User choices are: hmac-md5, hmac-sha1, hmac-sha224, hmac-sha256,
bcf15a19ae0efa72a22cdfb50666a3c6ce39eb9fTinderbox User hmac-sha384 and hmac-sha512. The default is hmac-sha256.
44d0f0256fbdce130a18655023c3b06bacacbd61Automatic Updater Prints a short summary of the options and arguments to
bcf15a19ae0efa72a22cdfb50666a3c6ce39eb9fTinderbox User <span><strong class="command">ddns-confgen</strong></span>.
44d0f0256fbdce130a18655023c3b06bacacbd61Automatic Updater<dt><span class="term">-k <em class="replaceable"><code>keyname</code></em></span></dt>
44d0f0256fbdce130a18655023c3b06bacacbd61Automatic Updater Specifies the key name of the DDNS authentication key.
bcf15a19ae0efa72a22cdfb50666a3c6ce39eb9fTinderbox User The default is <code class="constant">ddns-key</code> when neither
bcf15a19ae0efa72a22cdfb50666a3c6ce39eb9fTinderbox User the <code class="option">-s</code> nor <code class="option">-z</code> option is
bcf15a19ae0efa72a22cdfb50666a3c6ce39eb9fTinderbox User specified; otherwise, the default
bcf15a19ae0efa72a22cdfb50666a3c6ce39eb9fTinderbox User is <code class="constant">ddns-key</code> as a separate label
bcf15a19ae0efa72a22cdfb50666a3c6ce39eb9fTinderbox User followed by the argument of the option, e.g.,
bcf15a19ae0efa72a22cdfb50666a3c6ce39eb9fTinderbox User <code class="constant">ddns-key.example.com.</code>
44d0f0256fbdce130a18655023c3b06bacacbd61Automatic Updater The key name must have the format of a valid domain name,
bcf15a19ae0efa72a22cdfb50666a3c6ce39eb9fTinderbox User consisting of letters, digits, hyphens and periods.
bcf15a19ae0efa72a22cdfb50666a3c6ce39eb9fTinderbox User Quiet mode: Print only the key, with no explanatory text or
bcf15a19ae0efa72a22cdfb50666a3c6ce39eb9fTinderbox User usage examples.
bcf15a19ae0efa72a22cdfb50666a3c6ce39eb9fTinderbox User<dt><span class="term">-r <em class="replaceable"><code>randomfile</code></em></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Specifies a source of random data for generating the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein authorization. If the operating system does not provide a
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <code class="filename">/dev/random</code> or equivalent device, the
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein default source of randomness is keyboard input.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <code class="filename">randomdev</code> specifies the name of a
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein character device or file containing random data to be used
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein instead of the default. The special value
71c66a876ecca77923638d3f94cc0783152b2f03Mark Andrews <code class="filename">keyboard</code> indicates that keyboard input
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein should be used.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<dt><span class="term">-s <em class="replaceable"><code>name</code></em></span></dt>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Single host mode: The example <span><strong class="command">named.conf</strong></span> text
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein shows how to set an update policy for the specified
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein using the "name" nametype.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein The default key name is
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein ddns-key.<em class="replaceable"><code>name</code></em>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein Note that the "self" nametype cannot be used, since
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein the name to be updated may differ from the key name.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein 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
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews shows how to set an update policy for the specified
58d9e9169e7ab4355a0b0bfc13bc616bc5247dfeAutomatic Updater <em class="replaceable"><code>zone</code></em>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews using the "zonesub" nametype, allowing updates to all subdomain
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews names within
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein that <em class="replaceable"><code>zone</code></em>.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein This option cannot be used with the <code class="option">-s</code> option.
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<p><span class="citerefentry"><span class="refentrytitle">nsupdate</span>(1)</span>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span class="citerefentry"><span class="refentrytitle">named.conf</span>(5)</span>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>,
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein <em class="citetitle">BIND 9 Administrator Reference Manual</em>.
852ccdd42a71550c974111b49415204ffeca6573Automatic Updater<p><span class="corpauthor">Internet Systems Consortium</span>
852ccdd42a71550c974111b49415204ffeca6573Automatic Updater<table width="100%" summary="Navigation footer">
66f25f2ceeb589e67efe7af2413baaa3426b0042Automatic Updater<a accesskey="p" href="man.rndc-confgen.html">Prev</a>�</td>
66f25f2ceeb589e67efe7af2413baaa3426b0042Automatic Updater<td width="20%" align="center"><a accesskey="u" href="Bv9ARM.ch10.html">Up</a></td>
66f25f2ceeb589e67efe7af2413baaa3426b0042Automatic Updater<span class="application">rndc-confgen</span>�</td>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<td width="20%" align="center"><a accesskey="h" href="Bv9ARM.html">Home</a></td>
60e5e10f8d2e2b0c41e8abad38cacd867caa6ab2Rob Austein<td width="40%" align="right" valign="top">�</td>