4 .\" The Regents of the University of California. All rights reserved.
6 .\" Redistribution and use in source and binary forms, with or without
7 .\" modification, are permitted provided that the following conditions
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.
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
34 .\" Portions Copyright (c) 1993 by Digital Equipment Corporation.
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.
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
54 .\" from named.8 6.6 (Berkeley) 2/14/89
57 .Dt @XFER_INDOT_U@NAMED-XFER @SYS_OPS_EXT_U@
60 .Nm @XFER_INDOT@named-xfer
61 .Nd ancillary agent for inbound zone transfers
64 .Fl z Ar zone_to_transfer
67 .Op Fl d Ar debuglevel
68 .Op Fl l Ar debug_log_file
69 .Op Fl t Ar trace_file
75 is an ancillary program executed by
76 .Xr @INDOT@named @SYS_OPS_EXT@
77 to perform an inbound zone transfer. It is rarely executed directly, and then
78 only by system administrators who are trying to debug a zone transfer problem.
79 See RFC's 1033, 1034, and 1035 for more information on the Internet
84 .It Fl z Ar zone_to_transfer
85 specifies the name of the zone to be transferred.
87 specifies the name of the
89 into which the zone should be dumped
90 when it is received from the primary server.
92 specifies the serial number of our current copy of this zone. If the
94 we get from the primary server does not have a serial
95 number higher than this, the transfer will be aborted.
96 .It Fl d Ar debuglevel
97 Print debugging information.
100 is a number determines the level of messages printed.
101 .It Fl l Ar debug_log_file
102 Specifies a log file for debugging messages. The default is system-
103 dependent but is usually in
107 Note that this only applies if
110 .It Fl t Ar trace_file
113 which will contain a protocol trace of the zone
114 transfer. This is probably only of interest to people debugging the name
117 Use a different port number. The default is the standard port number
119 .Xr getservbyname @LIB_NETWORK_EXT@
123 Perform a restricted transfer of only the SOA, NS records and glue A records
124 for the zone. The SOA record will not be loaded by
125 .Xr @INDOT@named @SYS_OPS_EXT@
127 determine when to verify the NS records. See the
130 .Xr @INDOT@named @SYS_OPS_EXT@
131 for more information.
134 Additional arguments are taken as name server addresses in so-called
138 no host name are allowed here. At least one address must be specified.
139 Any additional addresses will be tried, in order, if the first one fails
140 to transfer to us successfully.
142 .Xr hostname @DESC_EXT@ ,
143 .Xr @INDOT@named @SYS_OPS_EXT@ ,
144 .Xr resolver @LIB_NETWORK_EXT@ ,
145 .Xr resolver @FORMAT_EXT@ ,
146 RFC 882, RFC 883, RFC 973, RFC 974, RFC 1033, RFC 1034, RFC 1035, RFC 1123,
147 .Dq Name Server Operations Guide for Sy BIND .