mirror of
https://git.FreeBSD.org/src.git
synced 2024-12-21 11:13:30 +00:00
147 lines
5.3 KiB
Groff
147 lines
5.3 KiB
Groff
.\" ++Copyright++ 1985
|
|
.\" -
|
|
.\" Copyright (c) 1985
|
|
.\" The Regents of the University of California. All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\" 3. All advertising materials mentioning features or use of this software
|
|
.\" must display the following acknowledgement:
|
|
.\" This product includes software developed by the University of
|
|
.\" California, Berkeley and its contributors.
|
|
.\" 4. Neither the name of the University nor the names of its contributors
|
|
.\" may be used to endorse or promote products derived from this software
|
|
.\" without specific prior written permission.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
.\" SUCH DAMAGE.
|
|
.\" -
|
|
.\" Portions Copyright (c) 1993 by Digital Equipment Corporation.
|
|
.\"
|
|
.\" Permission to use, copy, modify, and distribute this software for any
|
|
.\" purpose with or without fee is hereby granted, provided that the above
|
|
.\" copyright notice and this permission notice appear in all copies, and that
|
|
.\" the name of Digital Equipment Corporation not be used in advertising or
|
|
.\" publicity pertaining to distribution of the document or software without
|
|
.\" specific, written prior permission.
|
|
.\"
|
|
.\" THE SOFTWARE IS PROVIDED "AS IS" AND DIGITAL EQUIPMENT CORP. DISCLAIMS ALL
|
|
.\" WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES
|
|
.\" OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL DIGITAL EQUIPMENT
|
|
.\" CORPORATION BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
|
|
.\" DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
|
|
.\" PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
|
|
.\" ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
|
|
.\" SOFTWARE.
|
|
.\" -
|
|
.\" --Copyright--
|
|
.\"
|
|
.\" from named.8 6.6 (Berkeley) 2/14/89
|
|
.\"
|
|
.TH NAMED-XFER 8 "June 26, 1993"
|
|
.UC 4
|
|
.SH NAME
|
|
named-xfer \- ancillary agent for inbound zone transfers
|
|
.SH SYNOPSIS
|
|
.B named-xfer
|
|
.B \-z
|
|
.I zone_to_transfer
|
|
.B \-f
|
|
.I db_file
|
|
.B \-s
|
|
.I serial_no
|
|
[
|
|
.B \-d
|
|
.I debuglevel
|
|
] [
|
|
.B \-l
|
|
.I debug_log_file
|
|
] [
|
|
.B \-t
|
|
.I trace_file
|
|
] [
|
|
.B \-p
|
|
.I port#
|
|
] [
|
|
.B \-S
|
|
]
|
|
.I nameserver
|
|
...
|
|
.SH DESCRIPTION
|
|
.I Named-xfer
|
|
is an ancillary program executed by
|
|
.IR named (8)
|
|
to perform an inbound zone transfer. It is rarely executed directly, and
|
|
only by system administrators who are trying to debug a zone transfer problem.
|
|
See RFC's 1033, 1034, and 1035 for more information on the Internet
|
|
name-domain system.
|
|
.PP
|
|
Options are:
|
|
.TP
|
|
.B \-z
|
|
specifies the name of the zone to be transferred.
|
|
.TP
|
|
.B \-f
|
|
specifies the name of the file into which the zone should be dumped
|
|
when it is received from the primary server.
|
|
.TP
|
|
.B \-s
|
|
specifies the serial number of our current copy of this zone. If the
|
|
\s-1SOA RR\s+1 we get from the primary server does not have a serial
|
|
number higher than this, the transfer will be aborted.
|
|
.TP
|
|
.B \-d
|
|
Print debugging information.
|
|
A number after the ``d'' determines the level of
|
|
messages printed.
|
|
.TP
|
|
.B \-l
|
|
Specifies a log file for debugging messages. The default is system-
|
|
dependent but is usually in
|
|
.I /var/tmp
|
|
or
|
|
.IR /usr/tmp .
|
|
Note that this only applies if
|
|
.I \-d
|
|
is also specified.
|
|
.TP
|
|
.B \-t
|
|
Specifies a trace file which will contain a protocol trace of the zone
|
|
transfer. This is probably only of interest to people debugging the name
|
|
server itself.
|
|
.TP
|
|
.B \-p
|
|
Use a different port number. The default is the standard port number
|
|
as returned by getservbyname(3) for service ``domain''.
|
|
.TP
|
|
.B \-S
|
|
Perform a restricted transfer of only the SOA, NS records and glue A records
|
|
for the zone. The SOA record will not be loaded by named but will be used to
|
|
determine when to verify the NS records. See the ``stubs'' directive in
|
|
.IR named (8)
|
|
for more information.
|
|
.PP
|
|
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.
|
|
.SH "SEE ALSO"
|
|
named(8), resolver(3), resolver(5), hostname(7),
|
|
RFC 882, RFC 883, RFC 973, RFC 974, RFC 1033, RFC 1034, RFC 1035, RFC 1123,
|
|
\fIName Server Operations Guide for \s-1BIND\s+1\fR
|