nsupdate(1M) (man pages section 1M: System Administration Commands)

man pages section 1M: System Administration Commands

nsupdate(1M)

NAME

nsupdate- update DNS name servers

SYNOPSIS

nsupdate

-d

-v

filename

DESCRIPTION

nsupdate updates domain name servers. It has two modes: interactive and non-interactive. The interactive mode allows the user to update servers with information about various hosts and domains. The non-interactive mode allows for batch updates of zones. Both modes assume that the nameserver allows updates from the host where nsupdate is being run. See in.named(1M) for a discussion of the 'allow-update' option for configuring in.named.

OPTIONS

-d

Debug mode.

-v

Make use of TCP instead of UDP for updates.

filename

The name of the file containing the update requests and entries. Data in the file must contain one line per entry and should be of the form

class  section   name   ttl   type  rdata

where:

class: Any of the following opcodes: update, zone, or prereq.
section: One of the following opcodes: add, delete, nxdomain, yxdomain, nxrrset, yxrrset
name: The name of the entry being added.
ttl: The time to live (in seconds) for this entry.
type: The RR type, for example: a, cname, ns, mx, ptr or txt.
rdata: The data appropriate for the RR type being updated.

USAGE

Interactive Mode

In the interactive mode, the user is expected to provide the update data in the class section name ttl type rdata format against each prompt, with each field separated by a space. A return at with no data assumes the end of input and all update entries are the nameserver is updated in one atomic operation. A CTRL-D ends the interactive mode and exits the program.

Non-Interactive Mode

In the non-interactive mode, the user is expected to provide the update data in a file. Data in the file is in the form of rows and columns. Each row must contain the following update data:

class section name ttl type rdata

EXAMPLES

Example 1 `nsupdate` Session Using Interactive Mode

This example updates the nads.zn zone with a cname entry for ivy18.nads.zn as www.nads.zn.

example% nsupdate
res_mkupdate: packet size = 49
;; res_send()
;; ->>HEADER<<- opcode: UPDATE, status: NOERROR, id: 53349
;; flags:; ZONE: 1, PREREQUISITE: 0, UPDATE: 1, ADDITIONAL: 0
;;      nads.zn, type = SOA, class = IN
www.nads.zn.            1M IN CNAME     ivy18.nads.zn.
;; Querying server (# 1) address = 192.168.1.1
;; got answer:
;; ->>HEADER<<- opcode: UPDATE, status: NOERROR, id: 53349
;; flags: qr ra; ZONE: 0, PREREQUISITE: 0, UPDATE: 0, ADDITIONAL: 0

Example 2 Deleting an Entry in Interactive Mode

This example deletes the entry created in Example 1.

example% nsupdate
> update delete www.nads.zn. cname
>
;; res_mkquery(0, www.nads.zn, 1, 6)
;; res_send()
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 53350
;; flags: rd; QUERY: 1, ANSWER: 0, AUTHORITY: 0, ADDITIONAL: 0
;;      www.nads.zn, type = SOA, class = IN
;; Querying server (# 1) address = 192.168.1.1
;; got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 53350
;; flags: qr aa rd ra; QUERY: 1, ANSWER: 1, AUTHORITY: 1, ADDITIONAL: 0
;;      www.nads.zn, type = SOA, class = IN
www.nads.zn. 1M IN CNAME  ivy18.nads.zn.
nads.zn.     1D IN SOA    nserver.eng.nads.com. admin.myhost.eng.nads.com. (
                          1998012604      ; serial
                          3H              ; refresh
                          1H              ; retry
                          1W              ; expiry
                          1D )            ; minimum
 
;; res_mkquery(0, nads.zn, 1, 6)
;; res_send()
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 53351
;; flags: rd; QUERY: 1, ANSWER: 0, AUTHORITY: 0, ADDITIONAL: 0
;;      nads.zn, type = SOA, class = IN
;; Querying server (# 1) address = 192.168.1.1
;; got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 53351
;; flags: qr aa rd ra; QUERY: 1, ANSWER: 1, AUTHORITY: 1, ADDITIONAL: 1
;;      nads.zn, type = SOA, class = IN
nads.zn   1D IN SOA   nserver.eng.nads.com. admin.myhost.eng.nads.com. (
                      1998012604      ; serial
                      3H              ; refresh
                      1H              ; retry
                      1W              ; expiry
                      1D )            ; minimum
 
nads.zn.                1D IN NS        obelix.nads.zn.
obelix.nads.zn.         1D IN A         192.168.1.1
res_mkupdate: packet size = 41
;; res_send()
;; ->>HEADER<<- opcode: UPDATE, status: NOERROR, id: 53352
;; flags:; ZONE: 1, PREREQUISITE: 0, UPDATE: 1, ADDITIONAL: 0
;;      nads.zn, type = SOA, class = IN
;; Querying server (# 1) address = 192.168.1.1
;; got answer:
;; ->>HEADER<<- opcode: UPDATE, status: NOERROR, id: 53352
;; flags: qr ra; ZONE: 0, PREREQUISITE: 0, UPDATE: 0, ADDITIONAL: 0

Example 3 Using Non-Interactive Mode

example% nsupdate nsupd.txt
where nsupd.txt contains the following information
        update delete www.nads.zn.
        update add www.nads.zn. 60 CNAME ivy18.nads.zn

EXIT STATUS

The following exit values are returned:

0: Successful completion.
>0: An error occurred.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWcsu