man.ddns-confgen.html revision d893c6248414d34d434a63216eaa5bd1fbec4ca4
80833bb9a1bf25dcf19e814438a4b311d2e1f4cffuankg - Copyright (C) 2004-2010 Internet Systems Consortium, Inc. ("ISC")
a34684a59b60a4173c25035d0c627ef17e6dc215rpluem - Copyright (C) 2000-2003 Internet Software Consortium.
1337c7673efc1f80f634139fbad7cbb98a0dc657ylavic - Permission to use, copy, modify, and/or distribute this software for any
1337c7673efc1f80f634139fbad7cbb98a0dc657ylavic - purpose with or without fee is hereby granted, provided that the above
1337c7673efc1f80f634139fbad7cbb98a0dc657ylavic - copyright notice and this permission notice appear in all copies.
4da61833a1cbbca94094f9653fd970582b97a72etrawick - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
4da61833a1cbbca94094f9653fd970582b97a72etrawick - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
4da61833a1cbbca94094f9653fd970582b97a72etrawick - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
4da61833a1cbbca94094f9653fd970582b97a72etrawick - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
4789804be088bcd86ae637a29cdb7fda25169521jailletc - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
4789804be088bcd86ae637a29cdb7fda25169521jailletc - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
4789804be088bcd86ae637a29cdb7fda25169521jailletc - PERFORMANCE OF THIS SOFTWARE.
e50c3026198fd496f183cda4c32a202925476778covener<!-- $Id: man.ddns-confgen.html,v 1.59 2010/12/09 01:14:10 tbox Exp $ -->
5b88c8507d5ef6d0c4cfbc78230294968175b638minfrin<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
6c3b9cebb551140fbb25d58bae08b539b3802133ylavic<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
6c3b9cebb551140fbb25d58bae08b539b3802133ylavic<link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
6c3b9cebb551140fbb25d58bae08b539b3802133ylavic<link rel="up" href="Bv9ARM.ch10.html" title="Manual pages">
4f29b65ab4b547ad5dbe506e2d0ff5d12ead9247ylavic<link rel="prev" href="man.rndc-confgen.html" title="rndc-confgen">
4f29b65ab4b547ad5dbe506e2d0ff5d12ead9247ylavic<link rel="next" href="man.arpaname.html" title="arpaname">
0a0df13b7f1f4f1a74fe295253d89ca3911b301aylavic<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
69301145375a889e7e37caf7cc7321ac0f91801erpluem<tr><th colspan="3" align="center"><span class="application">ddns-confgen</span></th></tr>
506bfe33206b2fece40ef25f695af39dd4130facjkaluza<a accesskey="p" href="man.rndc-confgen.html">Prev</a>�</td>
506bfe33206b2fece40ef25f695af39dd4130facjkaluza<td width="20%" align="right">�<a accesskey="n" href="man.arpaname.html">Next</a>
2e6f4d654c96c98b761fb012fd25c5d5b1558c44sf<a name="man.ddns-confgen"></a><div class="titlepage"></div>
17e6c95f3b22d18acdf8380fb26a8d0e10c80767ylavic<p><span class="application">ddns-confgen</span> — ddns key generation tool</p>
e8bd80a4bb88199d2f9a24a50345688e52d9c116ylavic<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>
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavic<p><span><strong class="command">ddns-confgen</strong></span>
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavic generates a key for use by <span><strong class="command">nsupdate</strong></span>
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavic and <span><strong class="command">named</strong></span>. It simplifies configuration
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavic of dynamic zones by generating a key and providing the
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavic <span><strong class="command">nsupdate</strong></span> and <span><strong class="command">named.conf</strong></span>
d7205b1a86c51c27b71a2c458dc453fd53a261c1covener syntax that will be needed to use it, including an example
d7205b1a86c51c27b71a2c458dc453fd53a261c1covener <span><strong class="command">update-policy</strong></span> statement.
d7205b1a86c51c27b71a2c458dc453fd53a261c1covener If a domain name is specified on the command line, it will
44ff304057225e944e220e981d434a046d14cf06covener be used in the name of the generated key and in the sample
44ff304057225e944e220e981d434a046d14cf06covener <span><strong class="command">named.conf</strong></span> syntax. For example,
44ff304057225e944e220e981d434a046d14cf06covener <span><strong class="command">ddns-confgen example.com</strong></span> would
44ff304057225e944e220e981d434a046d14cf06covener generate a key called "ddns-key.example.com", and sample
5d1ba75b8794925e67591c209085a49279791de9covener <span><strong class="command">named.conf</strong></span> command that could be used
5d1ba75b8794925e67591c209085a49279791de9covener in the zone definition for "example.com".
032982212dbcc7c3cce95bf89c503bb56e185ac7kbrand Note that <span><strong class="command">named</strong></span> itself can configure a
032982212dbcc7c3cce95bf89c503bb56e185ac7kbrand local DDNS key for use with <span><strong class="command">nsupdate -l</strong></span>.
032982212dbcc7c3cce95bf89c503bb56e185ac7kbrand <span><strong class="command">ddns-confgen</strong></span> is only needed when a
caad2986f81ab263f7af41467dd622dc9add17f3ylavic more elaborate configuration is required: for instance, if
caad2986f81ab263f7af41467dd622dc9add17f3ylavic <span><strong class="command">nsupdate</strong></span> is to be used from a remote system.
2165214331e4afafca4048f66f303d0253d7b001covener<dt><span class="term">-a <em class="replaceable"><code>algorithm</code></em></span></dt>
a34684a59b60a4173c25035d0c627ef17e6dc215rpluem Specifies the algorithm to use for the TSIG key. Available
1e2d421a36999d292042a5539971070d54aa6c63ylavic choices are: hmac-md5, hmac-sha1, hmac-sha224, hmac-sha256,
1e2d421a36999d292042a5539971070d54aa6c63ylavic hmac-sha384 and hmac-sha512. The default is hmac-sha256.
fa7ed98b9dc94c5845cf845aea0a44ecacd290c9humbedooh Prints a short summary of the options and arguments to
0b67eb8568cd58bb77082703951679b42cf098actrawick <span><strong class="command">ddns-confgen</strong></span>.
0b67eb8568cd58bb77082703951679b42cf098actrawick<dt><span class="term">-k <em class="replaceable"><code>keyname</code></em></span></dt>
5ef3c61605a3a021ff71f488983cb0065f8e1a79covener Specifies the key name of the DDNS authentication key.
fb1985a97912b25ec6564c73e610a31e5fc6e25fcovener The default is <code class="constant">ddns-key</code> when neither
09c87c777bed1655621bb20e1c46cb6b1a63279dcovener the <code class="option">-s</code> nor <code class="option">-z</code> option is
6502b7b32f980cc2093bb3ebce37e5e4dc68fba4ylavic specified; otherwise, the default
6502b7b32f980cc2093bb3ebce37e5e4dc68fba4ylavic is <code class="constant">ddns-key</code> as a separate label
3060ce7f798fbda7999cd4ddf89b525d2b294185covener followed by the argument of the option, e.g.,
c1a63b8fad09c419c1a64f75993feb8a343a6801ylavic The key name must have the format of a valid domain name,
c1a63b8fad09c419c1a64f75993feb8a343a6801ylavic consisting of letters, digits, hyphens and periods.
e466c40e1801982602ee0200c9e8b61cc148742djailletc Quiet mode: Print only the key, with no explanatory text or
457468b82e59d01eba00dd9d0817309c8f5e414ejim usage examples.
457468b82e59d01eba00dd9d0817309c8f5e414ejim<dt><span class="term">-r <em class="replaceable"><code>randomfile</code></em></span></dt>
04983e3bd1754764eec7d6bb772fe3b0bf391771jorton Specifies a source of random data for generating the
15890c9306ba98f6fc243e15a3c4778ddc7d773erpluem authorization. If the operating system does not provide a
15660979a30d251681463de2e0584853890082accovener <code class="filename">/dev/random</code> or equivalent device, the
15660979a30d251681463de2e0584853890082accovener default source of randomness is keyboard input.
49dacedb6c387b786b7911082ff35121a45f414bcovener <code class="filename">randomdev</code> specifies the name of a
49dacedb6c387b786b7911082ff35121a45f414bcovener character device or file containing random data to be used
cfd9415521847b2f9394fad04fb701cfb955f503rjung instead of the default. The special value
cfd9415521847b2f9394fad04fb701cfb955f503rjung <code class="filename">keyboard</code> indicates that keyboard input
cfd9415521847b2f9394fad04fb701cfb955f503rjung should be used.
28c31fb73c1264bd1d0ff932573677030b024c7dwrowe<dt><span class="term">-s <em class="replaceable"><code>name</code></em></span></dt>
28c31fb73c1264bd1d0ff932573677030b024c7dwrowe Single host mode: The example <span><strong class="command">named.conf</strong></span> text
28c31fb73c1264bd1d0ff932573677030b024c7dwrowe shows how to set an update policy for the specified
63b9f1f5880391261705f696d7d65507bbe9ace3covener using the "name" nametype.
63b9f1f5880391261705f696d7d65507bbe9ace3covener The default key name is
63b9f1f5880391261705f696d7d65507bbe9ace3covener ddns-key.<em class="replaceable"><code>name</code></em>.
49dacedb6c387b786b7911082ff35121a45f414bcovener Note that the "self" nametype cannot be used, since
49dacedb6c387b786b7911082ff35121a45f414bcovener the name to be updated may differ from the key name.
49dacedb6c387b786b7911082ff35121a45f414bcovener This option cannot be used with the <code class="option">-z</code> option.
3c990331fc6702119e4f5b8ba9eae3021aea5265jim<dt><span class="term">-z <em class="replaceable"><code>zone</code></em></span></dt>
3c990331fc6702119e4f5b8ba9eae3021aea5265jim zone mode: The example <span><strong class="command">named.conf</strong></span> text
3c990331fc6702119e4f5b8ba9eae3021aea5265jim shows how to set an update policy for the specified
fc42512879dd0504532f52fe5d0d0383dda96a1eniq using the "zonesub" nametype, allowing updates to all subdomain
fc42512879dd0504532f52fe5d0d0383dda96a1eniq names within
0451df5dc50fa5d8b3e07d92ee6a92e36a1181a5niq This option cannot be used with the <code class="option">-s</code> option.
06b8f183140c8e02e0974e938a05078b511d1603covener<p><span class="citerefentry"><span class="refentrytitle">nsupdate</span>(1)</span>,
06b8f183140c8e02e0974e938a05078b511d1603covener <span class="citerefentry"><span class="refentrytitle">named.conf</span>(5)</span>,
06b8f183140c8e02e0974e938a05078b511d1603covener <span class="citerefentry"><span class="refentrytitle">named</span>(8)</span>,
15890c9306ba98f6fc243e15a3c4778ddc7d773erpluem <em class="citetitle">BIND 9 Administrator Reference Manual</em>.
15890c9306ba98f6fc243e15a3c4778ddc7d773erpluem<p><span class="corpauthor">Internet Systems Consortium</span>
8152945ae46857b170cb227e79bb799f4fc7710dminfrin<a accesskey="p" href="man.rndc-confgen.html">Prev</a>�</td>
8152945ae46857b170cb227e79bb799f4fc7710dminfrin<td width="20%" align="center"><a accesskey="u" href="Bv9ARM.ch10.html">Up</a></td>
8152945ae46857b170cb227e79bb799f4fc7710dminfrin<td width="40%" align="right">�<a accesskey="n" href="man.arpaname.html">Next</a>
4f0358189bfa57b8e75bd6b94db264302a8f336amrumph<td width="20%" align="center"><a accesskey="h" href="Bv9ARM.html">Home</a></td>
5716f9c6daa92dde5f2f9d11ed63f7c9549c223atrawick<td width="40%" align="right" valign="top">�<span class="application">arpaname</span>