50 lines
1.6 KiB
Groff
50 lines
1.6 KiB
Groff
.\" Generated by Mmark Markdown Processer - mmark.miek.nl
|
|
.TH "COREDNS-TRANSFER" 7 "March 2021" "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.
|
|
|