aboutsummaryrefslogtreecommitdiff
path: root/plugin/file/README.md
diff options
context:
space:
mode:
authorGravatar Miek Gieben <miek@miek.nl> 2020-07-07 21:38:07 +0200
committerGravatar GitHub <noreply@github.com> 2020-07-07 12:38:07 -0700
commit68f1dd5ddf0451cc3a1b24a72c2965b8d896ffba (patch)
treedfac4d4c60f1e3a088737e15119c7648f056e407 /plugin/file/README.md
parent435d27b58d813ccc01ecc6d8620b78929c516c25 (diff)
downloadcoredns-68f1dd5ddf0451cc3a1b24a72c2965b8d896ffba.tar.gz
coredns-68f1dd5ddf0451cc3a1b24a72c2965b8d896ffba.tar.zst
coredns-68f1dd5ddf0451cc3a1b24a72c2965b8d896ffba.zip
Implement notifies for transfer plugin (#3972)
* Fix notifies in transfer plugin Signed-off-by: Miek Gieben <miek@miek.nl> * Make it compile Signed-off-by: Miek Gieben <miek@miek.nl> * Port more plugins Signed-off-by: Miek Gieben <miek@miek.nl> * golint Signed-off-by: Miek Gieben <miek@miek.nl> * Fix tests Signed-off-by: Miek Gieben <miek@miek.nl> * Fix notifies in transfer plugin Signed-off-by: Miek Gieben <miek@miek.nl> * Make it compile Signed-off-by: Miek Gieben <miek@miek.nl> * Port more plugins Signed-off-by: Miek Gieben <miek@miek.nl> * golint Signed-off-by: Miek Gieben <miek@miek.nl> * Fix tests Signed-off-by: Miek Gieben <miek@miek.nl> * Fix tests Signed-off-by: Miek Gieben <miek@miek.nl> * really fix test Signed-off-by: Miek Gieben <miek@miek.nl> * Implement ixfr fallback and unify file and auto for transfering Signed-off-by: Miek Gieben <miek@miek.nl> * Add transfer tests copied and modified from #3452 Signed-off-by: Miek Gieben <miek@miek.nl> * Test correct selection of plugin Signed-off-by: Miek Gieben <miek@miek.nl> * add upstream back in Signed-off-by: Miek Gieben <miek@miek.nl> * Implement ixfr fallback and unify file and auto for transfering Signed-off-by: Miek Gieben <miek@miek.nl> * fix test Signed-off-by: Miek Gieben <miek@miek.nl> * properly merge Signed-off-by: Miek Gieben <miek@miek.nl>
Diffstat (limited to 'plugin/file/README.md')
-rw-r--r--plugin/file/README.md22
1 files changed, 10 insertions, 12 deletions
diff --git a/plugin/file/README.md b/plugin/file/README.md
index e80b6b0dc..3923322dd 100644
--- a/plugin/file/README.md
+++ b/plugin/file/README.md
@@ -26,19 +26,16 @@ If you want to round-robin A and AAAA responses look at the *loadbalance* plugin
~~~
file DBFILE [ZONES... ] {
- transfer to ADDRESS...
reload DURATION
}
~~~
-* `transfer` enables zone transfers. It may be specified multiples times. `To` or `from` signals
- the direction. **ADDRESS** must be denoted in CIDR notation (e.g., 127.0.0.1/32) or just as plain
- addresses. The special wildcard `*` means: the entire internet (only valid for 'transfer to').
- When an address is specified a notify message will be sent whenever the zone is reloaded.
* `reload` interval to perform a reload of the zone if the SOA version changes. Default is one minute.
Value of `0` means to not scan for changes and reload. For example, `30s` checks the zonefile every 30 seconds
and reloads the zone when serial changes.
+If you need outgoing zone transfers, take a look at the *transfer* plugin.
+
## Examples
Load the `example.org` zone from `example.org.signed` and allow transfers to the internet, but send
@@ -46,9 +43,9 @@ notifies to 10.240.1.1
~~~ corefile
example.org {
- file example.org.signed {
- transfer to *
- transfer to 10.240.1.1
+ file example.org.signed
+ transfer {
+ to * 10.240.1.1
}
}
~~~
@@ -57,9 +54,9 @@ Or use a single zone file for multiple zones:
~~~ corefile
. {
- file example.org.signed example.org example.net {
- transfer to *
- transfer to 10.240.1.1
+ file example.org.signed example.org example.net
+ transfer example.org example.net {
+ to * 10.240.1.1
}
}
~~~
@@ -94,4 +91,5 @@ example.org {
## Also See
-See the *loadbalance* plugin if you need simple record shuffling.
+See the *loadbalance* plugin if you need simple record shuffling. And the *transfer* plugin for zone
+transfers. Lastly the *root* plugin can help you specificy the location of the zone files.