aboutsummaryrefslogtreecommitdiff
path: root/plugin
diff options
context:
space:
mode:
authorGravatar Chris O'Haver <cohaver@infoblox.com> 2018-07-23 15:37:41 -0400
committerGravatar Miek Gieben <miek@miek.nl> 2018-07-23 20:37:41 +0100
commit992e7928c7c258628d2b13b769acc86781b9faea (patch)
tree0c745ffa12ad83bc711613a030a1472dbd9464a4 /plugin
parentb7ae8d4e86ac3b13d51f2995e04c48ba21cc5836 (diff)
downloadcoredns-992e7928c7c258628d2b13b769acc86781b9faea.tar.gz
coredns-992e7928c7c258628d2b13b769acc86781b9faea.tar.zst
coredns-992e7928c7c258628d2b13b769acc86781b9faea.zip
Document current limitations of loop (#1996)
* Document current limitations of loop * Update README.md
Diffstat (limited to 'plugin')
-rw-r--r--plugin/loop/README.md11
1 files changed, 9 insertions, 2 deletions
diff --git a/plugin/loop/README.md b/plugin/loop/README.md
index 0b02a5158..bf0b93b68 100644
--- a/plugin/loop/README.md
+++ b/plugin/loop/README.md
@@ -2,7 +2,7 @@
## Name
-*loop* - detect forwarding loops and halt the server.
+*loop* - detect simple forwarding loops and halt the server.
## Description
@@ -13,7 +13,7 @@ The plugin will try to send the query for up to 30 seconds. This is done to give
to start up. Once a query has been successfully sent *loop* disables itself to prevent a query of
death.
-The query send is `<random number>.<random number>.zone` with type set to HINFO.
+The query sent is `<random number>.<random number>.zone` with type set to HINFO.
## Syntax
@@ -38,3 +38,10 @@ After CoreDNS has started it stops the process while logging:
~~~ txt
plugin/loop: Seen "HINFO IN 5577006791947779410.8674665223082153551." more than twice, loop detected
~~~
+
+## Limitations
+
+This plugin only attempts to find simple static forwarding loops at start up time. To detect a loop, all of the following must be true
+
+* the loop must be present at start up time.
+* the loop must occur for at least the `HINFO` query type.