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