nsupdate.1 (2010 09)

n
nsupdate(1) nsupdate(1)
(BIND 9.3)
Operands
filename
A file of nsupdate commands, as described in the Input Format section. The default is standard
input.
Input Format
nsupdate reads commands from filename or standard input. Each command is supplied on exactly one
line of input. Some commands are for administrative purposes; others are either update instructions or
prerequisite checks on the contents of the zone. The checks set conditions that some name or set of
resource records (RRset) either exists or is absent from the zone. These conditions must be met if the
entire update request is to succeed. Updates will be rejected if the tests for the prerequisite conditions
fail.
Every update request consists of zero or more prerequisites and zero or more updates. This allows a suit-
ably authenticated update request to proceed if some specified resource records are present or missing
from the zone. The
send command or a blank input line causes the accumulated commands to be sent as
one Dynamic DNS update request to the name server.
The Commands
The command formats and their meaning are as follows:
; Lines beginning with a semicolon are comments and are ignored.
server servername [port]
Sends all dynamic update requests to the name server servername . When no server
statement is provided, nsupdate sends updates to the master server of the correct zone.
The MNAME field of that zone’s SOA record identifies the master server for that zone. port
is the port number on servername where the dynamic update requests are sent. If no
port number is specified, the default DNS port number of 53 is used.
local address [port]
Sends all dynamic update requests using the local address. When no local statement is
provided, nsupdate sends updates using an address and port chosen by the system.
port can additionally be used to make requests come from a specific port. If no port
number is specified, the system assigns one.
zone zonename
Specifies that all updates are to be made to the zone zonename.Ifno
zone statement is
provided,
nsupdate attempts to determine the correct zone to update, based on the rest
of the input.
class classname
Specifies the default class. If no class is specified, the default class is
IN.
key name secret
Specifies that all updates are to be TSIG-signed using the keyname keysecret pair. The
key command overrides any key specified on the command line with -y or -k.
prereq nxdomain domain-name
Requires that no resource record of any type exists with name domain-name .
prereq yxdomain domain-name
Requires that domain-name exists (has as at least one resource record of any type).
prereq nxrrset domain-name class type
Requires that no resource record exists of the specified type , class , and domain-name .If
class is omitted, IN (Internet) is assumed.
prereq yxrrset domain-name class type
Requires that a resource record of the specified type , class , and domain-name must exist.
If class is omitted, IN (Internet) is assumed.
prereq yxrrset domain-name class type data...
The data from each set of prerequisites of this form sharing a common type , class , and
domain-name are combined to form a set of RRs (resource records). This set of RRs must
exactly match the set of RRs existing in the zone at the given type , class , and domain-
name. The data are written in the standard text representation of the resource record’s
RDATA.
2 Hewlett-Packard Company − 2 − HP-UX 11i Version 3: September 2010