coredns/man/coredns-transfer.7

.\" Generated by Mmark Markdown Processer - mmark.miek.nl
.TH "COREDNS-TRANSFER" 7 "December 2020" "CoreDNS" "CoreDNS Plugins"

.SH "NAME"
.PP
\fItransfer\fP - perform (outgoing) zone transfers for other plugins.

.SH "DESCRIPTION"
.PP
This plugin answers zone transfers for authoritative plugins that implement \fB\fCtransfer.Transferer\fR.

.PP
\fItransfer\fP answers full zone transfer (AXFR) requests and incremental zone transfer (IXFR) requests
with AXFR fallback if the zone has changed.

.PP
When a plugin wants to notify it's secondaries it will call back into the \fItransfer\fP plugin.

.PP
The following plugins implement zone transfers using this plugin: \fIfile\fP, \fIauto\fP, \fIsecondary\fP, and
\fIkubernetes\fP. See \fB\fCtransfer.go\fR for implementation details if you are a plugin author that wants to
use this plugin.

.SH "SYNTAX"
.PP
.RS

.nf
transfer [ZONE...] {
  to ADDRESS...
}

.fi
.RE

.IP \(bu 4
\fBZONE\fP The zones \fItransfer\fP will answer zone transfer requests for. If left blank, the zones
are inherited from the enclosing server block. To answer zone transfers for a given zone,
there must be another plugin in the same server block that serves the same zone, and implements
\fB\fCtransfer.Transferer\fR.
.IP \(bu 4
\fB\fCto\fR \fBADDRESS...\fP The hosts \fItransfer\fP will transfer to. Use \fB\fC*\fR to permit transfers to all
addresses. \fBADDRESS\fP must be denoted in CIDR notation (e.g., 127.0.0.1/32) or just as plain
addresses. \fB\fCto\fR may be specified multiple times.


.SH "EXAMPLES"
.PP
See the specific plugins using this plugin for examples on it's usage.