mirror of
https://github.com/coredns/coredns.io.git
synced 2024-04-21 12:32:00 +00:00
43 lines
1.5 KiB
Markdown
43 lines
1.5 KiB
Markdown
+++
|
|
title = "transfer"
|
|
description = "*transfer* perform (outgoing) zone transfers for other plugins."
|
|
weight = 44
|
|
tags = ["plugin", "transfer"]
|
|
categories = ["plugin"]
|
|
date = "2020-09-24T18:42:39.8773989"
|
|
+++
|
|
|
|
## Description
|
|
|
|
This plugin answers zone transfers for authoritative plugins that implement `transfer.Transferer`.
|
|
|
|
*transfer* answers full zone transfer (AXFR) requests and incremental zone transfer (IXFR) requests
|
|
with AXFR fallback if the zone has changed.
|
|
|
|
When a plugin wants to notify it's secondaries it will call back into the *transfer* plugin.
|
|
|
|
The following plugins implement zone transfers using this plugin: *file*, *auto*, *secondary*, and
|
|
*kubernetes*. See `transfer.go` for implementation details if you are a plugin author that wants to
|
|
use this plugin.
|
|
|
|
## Syntax
|
|
|
|
~~~
|
|
transfer [ZONE...] {
|
|
to ADDRESS...
|
|
}
|
|
~~~
|
|
|
|
* **ZONE** The zones *transfer* 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
|
|
`transfer.Transferer`.
|
|
|
|
* `to` **ADDRESS...** The hosts *transfer* will transfer to. Use `*` to permit transfers to all
|
|
addresses. **ADDRESS** must be denoted in CIDR notation (e.g., 127.0.0.1/32) or just as plain
|
|
addresses. `to` may be specified multiple times.
|
|
|
|
## Examples
|
|
|
|
See the specific plugins using this plugin for examples on it's usage.
|