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