contrib/bind/doc/man/named-xfer.8

   1 .\" ++Copyright++ 1985
   2 .\" -
   3 .\" Copyright (c) 1985
   4 .\"    The Regents of the University of California.  All rights reserved.
   5 .\"
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that the following conditions
   8 .\" are met:
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\" 2. Redistributions in binary form must reproduce the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer in the
  13 .\"    documentation and/or other materials provided with the distribution.
  14 .\" 3. All advertising materials mentioning features or use of this software
  15 .\"    must display the following acknowledgement:
  16 .\"     This product includes software developed by the University of
  17 .\"     California, Berkeley and its contributors.
  18 .\" 4. Neither the name of the University nor the names of its contributors
  19 .\"    may be used to endorse or promote products derived from this software
  20 .\"    without specific prior written permission.
  21 .\"
  22 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  23 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  24 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  25 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  26 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  27 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  28 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  29 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  30 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  31 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  32 .\" SUCH DAMAGE.
  33 .\" -
  34 .\" Portions Copyright (c) 1993 by Digital Equipment Corporation.
  35 .\"
  36 .\" Permission to use, copy, modify, and distribute this software for any
  37 .\" purpose with or without fee is hereby granted, provided that the above
  38 .\" copyright notice and this permission notice appear in all copies, and that
  39 .\" the name of Digital Equipment Corporation not be used in advertising or
  40 .\" publicity pertaining to distribution of the document or software without
  41 .\" specific, written prior permission.
  42 .\"
  43 .\" THE SOFTWARE IS PROVIDED "AS IS" AND DIGITAL EQUIPMENT CORP. DISCLAIMS ALL
  44 .\" WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES
  45 .\" OF MERCHANTABILITY AND FITNESS.   IN NO EVENT SHALL DIGITAL EQUIPMENT
  46 .\" CORPORATION BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
  47 .\" DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
  48 .\" PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
  49 .\" ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
  50 .\" SOFTWARE.
  51 .\" -
  52 .\" Portions Copyright (c) 1999 by Check Point Software Technologies, Inc.
  53 .\"
  54 .\" Permission to use, copy, modify, and distribute this software for any
  55 .\" purpose with or without fee is hereby granted, provided that the above
  56 .\" copyright notice and this permission notice appear in all copies, and that
  57 .\" the name of Check Point Software Technologies Incorporated not be used
  58 .\" in advertising or publicity pertaining to distribution of the document
  59 .\" or software without specific, written prior permission.
  60 .\"
  61 .\" THE SOFTWARE IS PROVIDED "AS IS" AND CHECK POINT SOFTWARE TECHNOLOGIES
  62 .\" INCORPORATED DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
  63 .\" INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS.
  64 .\" IN NO EVENT SHALL CHECK POINT SOFTWARE TECHNOLOGIES INCORPRATED
  65 .\" BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR
  66 .\" ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER
  67 .\" IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
  68 .\" OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  69 .\"
  70 .\" --Copyright--
  71 .\"
  72 .\"     from named.8    6.6 (Berkeley) 2/14/89
  73 .\"
  74 .Dd June 26, 1993
  75 .Dt @XFER_INDOT_U@NAMED-XFER @SYS_OPS_EXT_U@
  76 .Os BSD 4
  77 .Sh NAME
  78 .Nm @XFER_INDOT@named-xfer
  79 .Nd ancillary agent for inbound zone transfers
  80 .Sh SYNOPSIS
  81 .Nm named-xfer
  82 .Fl z Ar zone_to_transfer
  83 .Fl f Ar db_file
  84 .Fl s Ar serial_no
  85 .Op Fl d Ar debuglevel
  86 .Op Fl l Ar debug_log_file
  87 .Op Fl i Ar ixfr_file
  88 .Op Fl t Ar trace_file
  89 .Op Fl p Ar port#
  90 .Op Fl S
  91 .Ar nameserver
  92 .Op Ar [ Sy axfr
  93 |
  94 .Op Sy ixfr ]
  95 .Sh DESCRIPTION
  96 .Ic Named-xfer
  97 is an ancillary program executed by
  98 .Xr @INDOT@named @SYS_OPS_EXT@
  99 to perform an inbound zone transfer.  It is rarely executed directly, and then
 100 only by system administrators who are trying to debug a zone transfer problem.
 101 See RFC's 1033, 1034, and 1035 for more information on the Internet
 102 name-domain system.
 103 .Pp
 104 Options are:
 105 .Bl -tag -width Fl
 106 .It Fl z Ar zone_to_transfer
 107 specifies the name of the zone to be transferred.
 108 .It Fl f Ar db_file
 109 specifies the name of the
 110 .Ar db_file
 111 into which the zone should be dumped
 112 when it is received from the primary server.
 113 .It Fl s Ar serial_no
 114 specifies the serial number of our current copy of this zone.  If the
 115 .Sy SOA RR
 116 we get from the primary server does not have a serial
 117 number higher than this, the transfer will be aborted.
 118 .It Fl d Ar debuglevel
 119 Print debugging information.
 120 The
 121 .Ar debuglevel
 122 is a number determines the level of messages printed.
 123 .It Fl l Ar debug_log_file
 124 Specifies a log file for debugging messages.  The default is system-
 125 dependent but is usually in
 126 .Pa /var/tmp
 127 or
 128 .Pa /usr/tmp .
 129 Note that this only applies if
 130 .Dq Fl d
 131 is also specified.
 132 .It Fl i Ar ixfr_file
 133 Specifies the name of the
 134 .Ar ixfr_file
 135 into which the zone changes from Incremental Zone Transfer (IXFR)
 136 should be dumped when it is received from the primary server.
 137 .It Fl t Ar trace_file
 138 Specifies a
 139 .Ar trace_file
 140 which will contain a protocol trace of the zone
 141 transfer.  This is probably only of interest to people debugging the name
 142 server itself.
 143 .It Fl p Ar port#
 144 Use a different port number.  The default is the standard port number
 145 as returned by
 146 .Xr getservbyname @LIB_NETWORK_EXT@
 147 for the service
 148 .Dq Li domain .
 149 .It Fl S
 150 Perform a restricted transfer of only the SOA, NS records and glue A records
 151 for the zone. The SOA record will not be loaded by
 152 .Xr @INDOT@named @SYS_OPS_EXT@
 153 but will be used to
 154 determine when to verify the NS records.  See the
 155 .Dq Li stubs
 156 directive in
 157 .Xr @INDOT@named @SYS_OPS_EXT@
 158 for more information.
 159 .El
 160 .Pp
 161 Additional arguments are taken as name server addresses in so-called
 162 .Dq dotted-quad
 163 syntax
 164 .Em only;
 165 no host name are allowed here.  At least one address must be specified.
 166 Any additional addresses will be tried, in order, if the first one fails
 167 to transfer to us successfully.
 168 The
 169 .Sy axfr
 170 or
 171 .Sy ixfr
 172 after name server address designates the type of zone transfer to perform.
 173 Use
 174 .Sy axfr
 175 for a full zone transfer or
 176 .Sy ixfr
 177 for an incremental zone transfer.
 178 .Sh SEE ALSO
 179 .Xr hostname @DESC_EXT@ ,
 180 .Xr @INDOT@named @SYS_OPS_EXT@ ,
 181 .Xr resolver @LIB_NETWORK_EXT@ ,
 182 .Xr resolver @FORMAT_EXT@ ,
 183 RFC 882, RFC 883, RFC 973, RFC 974, RFC 1033, RFC 1034, RFC 1035,
 184 RFC 1123, RFC 1995
 185 .Dq Name Server Operations Guide for Sy BIND .