named-xfer(1M)                                        named-xfer(1M)


       NAME
             named-xfer - Internet domain name server zone-transfer utility

       SYNOPSIS
             named-xfer [-P port] [-d debuglevel] [-f db_file ] [-l logfile] [-p port] [-q]
                   [-s serial] [-t tracefile] [-z zone] internet-address. . .

       DESCRIPTION
             The named-xfer command implements the zone-transfer function
             of the Internet name-domain system.  Since zone transfers are
             frequently time-consuming, named-xfer handles them
             asynchronously so that named(1M) can continue processing
             queries.

          Files
             /usr/tmp/xfer.ddt   default debugging output file

          Exit Codes
             named-xfer exits with status 0 if the zone is up-to-date or
             status 1 if the transfer succeeded.  An exit status of 2
             indicates that no server was reachable or that all connections
             timed out.  An exit status of 3 indicates that some other
             failure occurred, which will have been logged in the system
             log unless the -q  option was present.

       USAGE
             named-xfer transfers the zone specified by the -z option into
             the file db_file specified by the -f option.

             The -s  option specifies the expected serial number serial.
             If the current zone serial number is equal to the expected
             serial number, named-xfer  exits without transferring the
             zone.  Otherwise, named-xfer transfers the zone.

             If the -t option is specified, named-xfer logs tracing
             information to the specified tracefile.

             If the -d option is specified and debuglevel is non-zero,
             named-xfer logs debugging output.  Currently, all non-zero
             values for debuglevel are equivalent.

             The -l option specifies the logfile into which debugging
             information should be written.





                           Copyright 1994 Novell, Inc.               Page 1

      named-xfer(1M)                                        named-xfer(1M)


            The -p option specifies the listening port number at the
            remote server.  This is normally 53 (see /etc/services.)  The
            -P option can also be used to specify the listening port, but
            the value of port is expected to be in network byte-order.

            Normally, named-xfer records errors via the syslog(3G)
            mechanism.  The -q option causes syslog output to be
            suppressed.

            Any remaining arguments are taken to be Internet addresses
            specified in dotted-quad notation, for example, 128.212.65.67.
            named-xfer will attempt to transfer the specified zone from
            each server whose address is listed.

            named-xfer  is normally run by named.  There should be no need
            to run it manually, except when debugging a problem with the
            name-domain system.

      REFERENCES
            named(1M), syslog(3G)
            RFC974, RFC1034, RFC1035



























                          Copyright 1994 Novell, Inc.               Page 2