MAN page from Other bind-utils-8.2.3-1.i386.rpm

NSUPDATE

Section: Maintenance Commands (8)
Index
BSD mandoc
BSD 4

NAME

nsupdate - update Internet name servers interactively

SYNOPSIS

nsupdate[-k keydir:keyname ][-d][-v][filename]

DESCRIPTION

Nsupdateis a program to update Internet domain name serverssupporting dynamic update.Nsupdateuses the DNS resolver library to pass messagesto a DNS server requesting the additional or deletion ofDNS resource records (RRs).Nsupdatereads input fromfilenameor standard input.

ARGUMENTS

-k: Sign updates with TSIG.
-d: Debug mode.
-v: Virtual circuit - use TCP to communication with server.Default is UDP.

INPUT FORMAT

Nsupdatereads input records, one per line,each line contributing a resource record to anupdate request.All domain names used in a single update requestmust belong to the same DNS zone.Updates are sent to the master server as defined in the SOAMNAME field.A blank line causes the accumulatedrecords to be formated into a single update requestand transmitted to the zone's authoritative name servers.Additional records may follow,which are formed into additional,completely independent update requests.For the last request to be transmitted, a blank linemust end the input.

Records take one of two general forms.Prerequisiterecords specify conditions that must be satisfied beforethe request will be processed.Updaterecords specify changes to be made to the DNS database.A update request consists of zero or more prerequisitesand one or more updates.Each update request is processed atomically -all prerequisites must be satisfied, then all updateswill be performed.

Nsupdateunderstands the following input record formats:

prereq nxdomain domain-name: Requires that no RR of any type exists with namedomain-name
prereq yxdomain domain-name: Requires that at least one RR nameddomain-namemust exist.
prereq nxrrset domain-name [class]type: Requires that no RR exists of the specifiedtypeanddomain-name
prereq yxrrsetdomain-name [class]type [data...]: Requires that a RR exists of the specifiedtypeanddomain-name Ifdatais specified, it must match exactly.
update deletedomain-name [class][type [data...]]: Deletes RRs nameddomain-name Iftype(and possiblydata is specified,only matching records will be deleted.
update adddomain-name ttl [class]type data...: Adds a new RR with specifiedttl , type anddata

EXAMPLES

The following example illustrates the interactive use ofnsupdateto change an IP address by deleting any existing A recordsfor a domain name and then inserting a new one.Since no prerequisites are specified,the new record will be added even ifthere were no existing records to delete.Note thetrailing blank line, required to process the request.

$ nsupdate> update delete test.example.com A> update add test.example.com 3600 A 10.1.1.1>

In this example, a CNAME alias is added to the databaseonly if there are no existing A or CNAME records forthe domain name.

$ nsupdate> prereq nxrrset www.example.com A> prereq nxrrset www.example.com CNAME> update add www.example.com 3600 CNAME test.example.com>

In this example, the nsupdate will be signed with the key "mykey", whichis in the directory "/var/named/keys".

$ nsupdate -k /var/named/keys:mykey> update add ftp.example.com 60 A 192.168.5.1>

DIAGNOSTICS

Qq send error: Typically indicates that the authoritative nameservers could not be reached
Qq failed update packet: Typically indicates that the nameserver has rejected the update,either because the nameserver doesn't support dynamic update,or due to an authentication failure
Qq res_mkupdate: packet size = size: (and no other messages)The update was successfully received and authenticated by the nameserver.The prerequisites, however, may have prevented the update from actuallybeing performed. The only way to determine if the update was performedis to use debug mode-( d and examine the status field in the nameserver's reply.

FILES

/etc/resolv.conf

initial domain name and name server addresses

AUTHOR

Brent Baccala

This document was created byman2html,using the manual pages.