Miek Gieben 176e0916fe mw/chaos: update docs (#1055)
* mw/chaos: update docs

Fix/update the documentation: make the corefile snippets tested and
expand them a little. Show `dig` example.

Fixes #1050

* dot
2017-09-10 21:01:49 +01:00
..
2017-09-10 21:01:49 +01:00
2017-05-22 08:09:35 -04:00

chaos

The chaos middleware allows CoreDNS to respond to TXT queries in the CH class.

This is useful for retrieving version or author information from the server.

Syntax

chaos [VERSION] [AUTHORS...]
  • VERSION is the version to return. Defaults to CoreDNS-<version>, if not set.
  • AUTHORS is what authors to return. No default.

Note that you have to make sure that this middleware will get actual queries for the following zones: version.bind, version.server, authors.bind, hostname.bind and id.server.

Examples

Specify all the zones in full.

version.bind version.server authors.bind hostname.bind id.server {
    chaos CoreDNS-001 info@coredns.io
}

Or just default to .:

.  {
    chaos CoreDNS-001 info@coredns.io
}

And test with dig:

% dig @localhost CH TXT version.bind
...
;; ANSWER SECTION:
version.bind.		0	CH	TXT	"CoreDNS-001"
...