HP-UX Reference (11i v1 00/12) - 1M System Administration Commands N-Z (vol 4)

__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man1m/naaagt.1m
________________________________________________________________
___ ___
n
named-xfer(1M) named-xfer(1M)
NAME
named-xfer - ancillary agent for inbound zone transfers
SYNOPSIS
named-xfer -z zone_to_transfer -f db_file -s serial_no [-d debuglevel ][-l debug_log_file]
[-t trace_file][-p port#][-S ] nameserver...
DESCRIPTION
named-xfer is an ancillary program executed by named(1M) to perform an inbound zone transfer. It is
rarely executed directly, and then generally by system administrators trying to debug a zone transfer prob-
lem. See RFC’s 1033, 1034, and 1035 for more information on the Internet name-domain system.
Options are:
-z specifies the name of the zone to be transferred.
-f specifies the name of the file into which the zone should be dumped when it is received from the pri-
mary server.
-s specifies the serial number of the current copy of the zone selected for transfer. If the SOA resource
record received from the specified remote nameserver(s) does not have a serial number higher than
one specified with this option, the transfer will be aborted.
-d Print debugging information. A number after the d determines the level of messages printed.
-l Specifies a log file for debugging messages. The default file uses the prefix
xfer.ddt. and is
located in the
/var/tmp directory. Note this option only applies if -d is also specified.
-t Specifies a trace file which will contain a protocol trace of the zone transfer. This is probably only of
interest when debugging the name server itself.
-p Use a different port number. The default is the standard port number as returned by get-
servbyname(3) for service ‘domain’’.
-S Perform a restricted transfer of only the SOA, NS and glue A records for the zone. The SOA will not
be loaded by named, but will be used to determine when to verify the NS records. See the
stubs
directive in named(1M) for more information.
Additional arguments are taken as name server addresses in so-called ‘dotted-quad’’ syntax only; no host
name are allowed here. At least one address must be specified. Any additional addresses will be tried in
order if the first one fails to transfer to us successfully.
RETURN VALUE
0 Indicates that the zone was up-to-date and no transfer was needed.
1 Indicates a successful transfer.
2 Indicates that the host(s) named-xfer queried cannot be reached or that an error occurred and
named-xfer did not log a corresponding error message.
3 Indicates that an error occurred and named-xfer logged an error message.
AUTHOR
named-xfer was developed by the University of California, Berkeley.
SEE ALSO
named(1M), resolver(3N), resolver(4), hostname(5).
RFC 882, RFC 883, RFC 973, RFC 974, RFC 1033, RFC 1034, RFC 1035, RFC 1123.
Section 1M524 1 HP-UX Release 11i: December 2000
___
___