History

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
..
chaos.go	Fix import path `github.com/miekg/coredns` -> `github.com/coredns/coredns` (#547 )	2017-02-22 06:51:47 +00:00
chaos_test.go	Fix import path `github.com/miekg/coredns` -> `github.com/coredns/coredns` (#547 )	2017-02-22 06:51:47 +00:00
README.md	mw/chaos: update docs (#1055 )	2017-09-10 21:01:49 +01:00
setup.go	middleware/chaos: fix version (#669 )	2017-05-22 08:09:35 -04:00
setup_test.go	middleware/chaos: fix version (#669 )	2017-05-22 08:09:35 -04:00

README.md

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"
...