aboutsummaryrefslogtreecommitdiff
path: root/plugin/bind/README.md
diff options
context:
space:
mode:
authorGravatar Francois Tur <ftur@infoblox.com> 2018-02-14 14:19:32 -0500
committerGravatar Miek Gieben <miek@miek.nl> 2018-02-14 20:19:32 +0100
commit76455c6a0deb812db4a6a091cdf305ef4960c5b7 (patch)
tree8250653a6d6b8bb304f8e9d7f4ccd23f8ff32263 /plugin/bind/README.md
parenta0834b1dd50ea6d46b0e28c66868dec03422bdd5 (diff)
downloadcoredns-76455c6a0deb812db4a6a091cdf305ef4960c5b7.tar.gz
coredns-76455c6a0deb812db4a6a091cdf305ef4960c5b7.tar.zst
coredns-76455c6a0deb812db4a6a091cdf305ef4960c5b7.zip
Plugin/BIND - extend the syntax to allow multiple addresses (#1512)
* Extend bind to allow multiple addresses. UTs added. Changes the log for server starting, adding address when available * update readme for bind * fixes after review * minor fix on readme * accept multiple BIND directives in blocserver, consolidate the addresses * fixes after review - format logging server address, variable names
Diffstat (limited to 'plugin/bind/README.md')
-rw-r--r--plugin/bind/README.md33
1 files changed, 28 insertions, 5 deletions
diff --git a/plugin/bind/README.md b/plugin/bind/README.md
index 989a65b28..a33a6c8da 100644
--- a/plugin/bind/README.md
+++ b/plugin/bind/README.md
@@ -6,23 +6,46 @@
## Description
-Normally, the listener binds to the wildcard host. However, you may force the listener to bind to
-another IP instead. This directive accepts only an address, not a port.
+Normally, the listener binds to the wildcard host. However, you may want the listener to bind to
+another IP instead.
+
+If several addresses are provided, a listener will be open on each of the IP provided.
+
+Each address has to be an IP of one of the interfaces of the host.
## Syntax
~~~ txt
-bind ADDRESS
+bind ADDRESS ...
~~~
-**ADDRESS** is the IP address to bind to.
+**ADDRESS** is an IP address to bind to.
+When several addresses are provided a listener will be opened on each of the addresses.
## Examples
To make your socket accessible only to that machine, bind to IP 127.0.0.1 (localhost):
-~~~
+~~~ corefile
. {
bind 127.0.0.1
}
~~~
+
+To allow processing DNS requests only local host on both IPv4 and IPv6 stacks, use the syntax:
+
+~~~ corefile
+. {
+ bind 127.0.0.1 ::1
+}
+~~~
+
+If the configuration comes up with several *bind* directives, all addresses are consolidated together:
+The following sample is equivalent to the preceding:
+
+~~~ corefile
+. {
+ bind 127.0.0.1
+ bind ::1
+}
+~~~