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