This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

`named-xfer`

Ancillary agent for inbound zone transfers

Syntax:

named-xfer  -z zone_to_transfer 
            -f db_file 
           [-C class] 
           [-d debuglevel] 
           [-i ixfr_file] 
           [-l debug_log_file]
           [-p port_number] 
           [-q]  
           [-S]  
           [-s serial_no] 
           [-T tsig_info_file] 
           [-t trace_file] 
           [-x axfr-src] 
           nameserver... [[axfr] | [ixfr]]

Options:

-C class: Request an RR from the class "in" (the default), "hs," or "chaos".
-d debuglevel: Print debugging information. The debuglevel is a number determined by the level of messages printed.
-i ixfr_file: Specify the name of the file where zone changes from the Incremental Zone Transfer (IXFR) should be dumped when it's received from the primary server.
-f db_file: Specify the name of the zone data file into which the zone should be dumped when it's received from the primary server.
-l debug_log_file: Specify a log file for debugging messages. The default is system-dependent but is usually in /var/tmp or /usr/tmp. This option only applies if the -d option is specified.
-p port_number: Use a different port_number. The default is the standard port number returned by getservbyname().
-q: Quiet mode.
-S: Perform a restricted transfer of only the SOA, NS records and glue A records for the zone. The SOA record isn't loaded by named but is used to determine when to verify the NS records.
-s serial_no: Specify the serial number of our current copy of this zone. If the SOA RR from the primary server doesn't have a serial number higher than this, the transfer is aborted.
-T tsig_info_file: Info file that contains the TSIG (transaction signature) entries that are required for server authentication. For more information, see the section on the TSIG info file in the Description.
-t trace_file: Specify a trace_file that contains a protocol trace of the zone transfer. This is probably only of interest to people debugging the name server itself.
-x axfr-src: Local address of the zone transfer connection.
-z zone_to_transfer: Specify the name of the zone to be transferred.
nameserver: Specify the name server.
Additional arguments are taken as name server addresses in so-called "dotted-quad" syntax only; no hostnames are allowed here. At least one address must be specified. Any additional addresses are tried, in order, if the first one fails to transfer to us successfully.
axfr: Perform a full zone transfer.
ixfr: Perform an incremental zone transfer.

The named-xfer program is executed by named to perform an inbound zone transfer. It's rarely executed directly, and then only by system administrators who are trying to debug a zone transfer problem. See RFCs 1033, 1034, and 1035 for more information on the Internet name domain system.

The TSIG info file

The TSIG (transaction signatures) info file is used by named when performing zone transfers; it can be used for debugging purposes. The format of the entries in the file are as follows:

server_ip\n: IP address of the nameserver.
zone\n: Request this zone.
algorithm\n: Use this algorithm (decimal). Currently only 157 is supported (HMAC-MD5).
key\n: The TSIG key used by the server to authenticate.

For example:

11.0.0.1
qnx.com.
157
skrKc4Twy/cIgIykQu7JZA==

When named-xfer is finished it deletes this file. This is the normal operation when it's used with named.

`named-xfer`

Syntax:

Options:

Description:

The TSIG info file

See also: