man.nsupdate.html revision ae7449c457c21f990d588709fce9fa317d633d94
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater - Copyright (C) 2004-2012 Internet Systems Consortium, Inc. ("ISC")
71cef386fae61275b03e203825680b39fedaa8c6Tinderbox User - Copyright (C) 2000-2003 Internet Software Consortium.
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - Permission to use, copy, modify, and/or distribute this software for any
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - purpose with or without fee is hereby granted, provided that the above
5347c0fcb04eaea19d9f39795646239f487c6207Tinderbox User - copyright notice and this permission notice appear in all copies.
d6fa26d0adaec6c910115be34fe7a5a5f402c14fMark Andrews - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
fd2597f75693a2279fdf588bd40dfe2407c42028Tinderbox User - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
cd32f419a8a5432fbb139f56ee73cbf68b9350ccTinderbox User - PERFORMANCE OF THIS SOFTWARE.
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater<link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater<link rel="up" href="Bv9ARM.ch10.html" title="Manual pages">
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater<link rel="prev" href="man.named-journalprint.html" title="named-journalprint">
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater<link rel="next" href="man.rndc.html" title="rndc">
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater<table width="100%" summary="Navigation header">
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater<tr><th colspan="3" align="center"><span class="application">nsupdate</span></th></tr>
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater<a accesskey="p" href="man.named-journalprint.html">Prev</a>�</td>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<th width="60%" align="center">Manual pages</th>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<td width="20%" align="right">�<a accesskey="n" href="man.rndc.html">Next</a>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<a name="man.nsupdate"></a><div class="titlepage"></div>
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater<p><span class="application">nsupdate</span> — Dynamic DNS update utility</p>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<div class="cmdsynopsis"><p><code class="command">nsupdate</code> [<code class="option">-d</code>] [<code class="option">-D</code>] [[<code class="option">-g</code>] | [<code class="option">-o</code>] | [<code class="option">-l</code>] | [<code class="option">-y <em class="replaceable"><code>[<span class="optional">hmac:</span>]keyname:secret</code></em></code>] | [<code class="option">-k <em class="replaceable"><code>keyfile</code></em></code>]] [<code class="option">-t <em class="replaceable"><code>timeout</code></em></code>] [<code class="option">-u <em class="replaceable"><code>udptimeout</code></em></code>] [<code class="option">-r <em class="replaceable"><code>udpretries</code></em></code>] [<code class="option">-R <em class="replaceable"><code>randomdev</code></em></code>] [<code class="option">-v</code>] [<code class="option">-T</code>] [<code class="option">-P</code>] [filename]</p></div>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<p><span><strong class="command">nsupdate</strong></span>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User is used to submit Dynamic DNS Update requests as defined in RFC 2136
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User to a name server.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User This allows resource records to be added or removed from a zone
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User without manually editing the zone file.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User A single update request can contain requests to add or remove more than
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User resource record.
3b0259a9571e91b39929b9306e74c20db07d9101Tinderbox User Zones that are under dynamic control via
3b0259a9571e91b39929b9306e74c20db07d9101Tinderbox User <span><strong class="command">nsupdate</strong></span>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User or a DHCP server should not be edited by hand.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Manual edits could
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User conflict with dynamic updates and cause data to be lost.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User The resource records that are dynamically added or removed with
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span><strong class="command">nsupdate</strong></span>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User have to be in the same zone.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Requests are sent to the zone's master server.
7e71f05d8643aca84914437c900cb716444507e4Tinderbox User This is identified by the MNAME field of the zone's SOA record.
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater <span><strong class="command">nsupdate</strong></span>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt operate in debug mode.
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater This provides tracing information about the update requests that are
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater made and the replies received from the name server.
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater The <code class="option">-D</code> option makes <span><strong class="command">nsupdate</strong></span>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt report additional debugging information to <code class="option">-d</code>.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User The <code class="option">-L</code> option with an integer argument of zero or
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater higher sets the logging debug level. If zero, logging is disabled.
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater Transaction signatures can be used to authenticate the Dynamic
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater DNS updates. These use the TSIG resource record type described
77dccf2a5d9327d16b4374a135cdb99bdd48620eAutomatic Updater in RFC 2845 or the SIG(0) record described in RFC 2535 and
77dccf2a5d9327d16b4374a135cdb99bdd48620eAutomatic Updater RFC 2931 or GSS-TSIG as described in RFC 3645. TSIG relies on
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater a shared secret that should only be known to
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span><strong class="command">nsupdate</strong></span> and the name server. Currently,
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User the only supported encryption algorithm for TSIG is HMAC-MD5,
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User which is defined in RFC 2104. Once other algorithms are
7e71f05d8643aca84914437c900cb716444507e4Tinderbox User defined for TSIG, applications will need to ensure they select
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User the appropriate algorithm as well as the key when authenticating
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User each other. For instance, suitable <span class="type">key</span> and
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span class="type">server</span> statements would be added to
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater <code class="filename">/etc/named.conf</code> so that the name server
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User can associate the appropriate secret key and algorithm with
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User the IP address of the client application that will be using
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User TSIG authentication. SIG(0) uses public key cryptography.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt To use a SIG(0) key, the public key must be stored in a KEY
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater record in a zone served by the name server.
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater <span><strong class="command">nsupdate</strong></span> does not read
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater <code class="filename">/etc/named.conf</code>.
7717ec7a6a898cdd3c35cbfba66010b7304ffd9bAutomatic Updater GSS-TSIG uses Kerberos credentials. Standard GSS-TSIG mode
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User is switched on with the <code class="option">-g</code> flag. A
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User non-standards-compliant variant of GSS-TSIG used by Windows
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater 2000 can be switched on with the <code class="option">-o</code> flag.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<p><span><strong class="command">nsupdate</strong></span>
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater uses the <code class="option">-y</code> or <code class="option">-k</code> option
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User to provide the shared secret needed to generate a TSIG record
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User for authenticating Dynamic DNS update requests, default type
a3f8c8e20780e488141d200acdfea6c5f3303513Automatic Updater HMAC-MD5. These options are mutually exclusive.
a3f8c8e20780e488141d200acdfea6c5f3303513Automatic Updater When the <code class="option">-y</code> option is used, a signature is
a3f8c8e20780e488141d200acdfea6c5f3303513Automatic Updater generated from
a3f8c8e20780e488141d200acdfea6c5f3303513Automatic Updater [<span class="optional"><em class="parameter"><code>hmac:</code></em></span>]<em class="parameter"><code>keyname:secret.</code></em>
a3f8c8e20780e488141d200acdfea6c5f3303513Automatic Updater <em class="parameter"><code>keyname</code></em> is the name of the key, and
ef8014e56f35bb36daa5fd2c313f5e7963e97aa1Tinderbox User <em class="parameter"><code>secret</code></em> is the base64 encoded shared secret.
ef8014e56f35bb36daa5fd2c313f5e7963e97aa1Tinderbox User Use of the <code class="option">-y</code> option is discouraged because the
ef8014e56f35bb36daa5fd2c313f5e7963e97aa1Tinderbox User shared secret is supplied as a command line argument in clear text.
ef8014e56f35bb36daa5fd2c313f5e7963e97aa1Tinderbox User This may be visible in the output from
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span class="citerefentry"><span class="refentrytitle">ps</span>(1)</span>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User or in a history file maintained by the user's shell.
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User <code class="option">-k</code> option, <span><strong class="command">nsupdate</strong></span> reads
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User the shared secret from the file <em class="parameter"><code>keyfile</code></em>.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Keyfiles may be in two formats: a single file containing
6f1205897504b8f50b1785975482c995888dd630Tinderbox User a <code class="filename">named.conf</code>-format <span><strong class="command">key</strong></span>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User statement, which may be generated automatically by
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span><strong class="command">ddns-confgen</strong></span>, or a pair of files whose names are
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User of the format <code class="filename">K{name}.+157.+{random}.key</code> and
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <code class="filename">K{name}.+157.+{random}.private</code>, which can be
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User generated by <span><strong class="command">dnssec-keygen</strong></span>.
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater The <code class="option">-k</code> may also be used to specify a SIG(0) key used
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User to authenticate Dynamic DNS update requests. In this case, the key
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User specified is not an HMAC-MD5 key.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span><strong class="command">nsupdate</strong></span> can be run in a local-host only mode
8ec3c085233cedb22b05da36e2773c8f357a7e45Automatic Updater using the <code class="option">-l</code> flag. This sets the server address to
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User localhost (disabling the <span><strong class="command">server</strong></span> so that the server
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User address cannot be overridden). Connections to the local server will
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User use a TSIG key found in <code class="filename">/var/run/named/session.key</code>,
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User which is automatically generated by <span><strong class="command">named</strong></span> if any
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User local master zone has set <span><strong class="command">update-policy</strong></span> to
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User <span><strong class="command">local</strong></span>. The location of this key file can be
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User overridden with the <code class="option">-k</code> option.
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User By default, <span><strong class="command">nsupdate</strong></span>
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User uses UDP to send update requests to the name server unless they are too
6ea2385360e9e2167e65f9286447da9eea189457Tinderbox User large to fit in a UDP request in which case TCP will be used.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span><strong class="command">nsupdate</strong></span>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User use a TCP connection.
7e71f05d8643aca84914437c900cb716444507e4Tinderbox User This may be preferable when a batch of update requests is made.
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater The <code class="option">-p</code> sets the default port number to use for
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater connections to a name server. The default is 53.
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater The <code class="option">-t</code> option sets the maximum time an update request
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater take before it is aborted. The default is 300 seconds. Zero can be
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater to disable the timeout.
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater The <code class="option">-u</code> option sets the UDP retry interval. The default
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User 3 seconds. If zero, the interval will be computed from the timeout
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater and number of UDP retries.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User The <code class="option">-r</code> option sets the number of UDP retries. The
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User 3. If zero, only one update request will be made.
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User The <code class="option">-R <em class="replaceable"><code>randomdev</code></em></code> option
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User specifies a source of randomness. If the operating system
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User does not provide a <code class="filename">/dev/random</code> or
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater equivalent device, the default source of randomness is keyboard
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User input. <code class="filename">randomdev</code> specifies the name of
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User a character device or file containing random data to be used
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater instead of the default. The special value
5a24d24c8fba3480d707c0c902379ddb36501e12Automatic Updater <code class="filename">keyboard</code> indicates that keyboard input
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater should be used. This option may be specified multiple times.
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater Other types can be entered using "TYPEXXXXX" where "XXXXX" is the
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User decimal value of the type with no leading zeros. The rdata,
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User if present, will be parsed using the UNKNOWN rdata format,
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater (<backslash> <hash> <space> <length>
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater <space> <hexstring>).
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User The <code class="option">-T</code> and <code class="option">-P</code> options print out
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater lists of non-meta types for which the type-specific presentation
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User formats are known. <code class="option">-T</code> prints out the list of
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User IANA-assigned types. <code class="option">-P</code> prints out the list of
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater private types specific to <span><strong class="command">named</strong></span>. These options
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater may be combined. <span><strong class="command">nsupdate</strong></span> will exit after the
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater lists are printed.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User<p><span><strong class="command">nsupdate</strong></span>
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater reads input from
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater <em class="parameter"><code>filename</code></em>
f8e3e03cacd16ffb923a9603fca23a9e1a1fee07Automatic Updater or standard input.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Each command is supplied on exactly one line of input.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Some commands are for administrative purposes.
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User The others are either update instructions or prerequisite checks on the
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User contents of the zone.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User These checks set conditions that some name or set of
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User resource records (RRset) either exists or is absent from the zone.
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User These conditions must be met if the entire update request is to succeed.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Updates will be rejected if the tests for the prerequisite conditions
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Every update request consists of zero or more prerequisites
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater and zero or more updates.
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater This allows a suitably authenticated update request to proceed if some
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater specified resource records are present or missing from the zone.
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater A blank input line (or the <span><strong class="command">send</strong></span> command)
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater accumulated commands to be sent as one Dynamic DNS update request to the
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater The command formats and their meaning are as follows:
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater <span><strong class="command">server</strong></span>
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater Sends all dynamic update requests to the name server
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater <em class="parameter"><code>servername</code></em>.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User When no server statement is provided,
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater <span><strong class="command">nsupdate</strong></span>
9d557856c2a19ec95ee73245f60a92f8675cf5baTinderbox User will send updates to the master server of the correct zone.
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater The MNAME field of that zone's SOA record will identify the
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User server for that zone.
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater <em class="parameter"><code>port</code></em>
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater is the port number on
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater <em class="parameter"><code>servername</code></em>
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater where the dynamic update requests get sent.
3acf5eb97cebc2ba868e6ac4a4e01e6d1be0c892Automatic Updater If no port number is specified, the default DNS port number of
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span><strong class="command">local</strong></span>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Sends all dynamic update requests using the local
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater <em class="parameter"><code>address</code></em>.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User When no local statement is provided,
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span><strong class="command">nsupdate</strong></span>
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater will send updates using an address and port chosen by the
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User can additionally be used to make requests come from a specific
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User If no port number is specified, the system will assign one.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span><strong class="command">zone</strong></span>
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User Specifies that all updates are to be made to the zone
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater <em class="parameter"><code>zonename</code></em>.
2895f101b5585a19015ac2c2c1e1812ac467fa12Automatic Updater statement is provided,
44d0f0256fbdce130a18655023c3b06bacacbd61Automatic Updater <span><strong class="command">nsupdate</strong></span>
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User will attempt determine the correct zone to update based on the
e62b9c9ce6413fb183c8116381e75dcd07ca5517Tinderbox User rest of the input.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span><strong class="command">class</strong></span>
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User Specify the default class.
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User If no <em class="parameter"><code>class</code></em> is specified, the
7e71f05d8643aca84914437c900cb716444507e4Tinderbox User default class is
7911e6f9de303bca5a3d8b34f4330c8f7cecffaeTinderbox User <span><strong class="command">ttl</strong></span>
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater Specify the default time to live for records to be added.
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater The value <em class="parameter"><code>none</code></em> will clear the default
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater <span><strong class="command">key</strong></span>
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater Specifies that all updates are to be TSIG-signed using the
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater <em class="parameter"><code>keyname</code></em> <em class="parameter"><code>keysecret</code></em> pair.
cd32f419a8a5432fbb139f56ee73cbf68b9350ccTinderbox User The <span><strong class="command">key</strong></span> command
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater overrides any key specified on the command line via
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater <code class="option">-y</code> or <code class="option">-k</code>.
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater <span><strong class="command">gsstsig</strong></span>
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater Use GSS-TSIG to sign the updated. This is equivalent to
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater specifying <code class="option">-g</code> on the commandline.
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater <span><strong class="command">oldgsstsig</strong></span>
590c12cfe3b9a179ab2faa1be791a069c81882e0Automatic Updater Use the Windows 2000 version of GSS-TSIG to sign the updated.
<span><strong class="command">[<span class="optional">update</span>] del[<span class="optional">ete</span>]</strong></span>
> update delete oldhost.example.com A
> update add newhost.example.com 86400 A 172.16.1.1
> prereq nxdomain nickname.example.com