coredns.io/content/plugins/chaos.md

+++ title = "chaos" description = "chaos allows for responding to TXT queries in the CH class." weight = 5 tags = [ "plugin", "chaos" ] categories = [ "plugin" ] date = "2018-10-17T18:39:57.645161" +++

Description

This is useful for retrieving version or author information from the server by querying a TXT record for a special domainname in the CH class.

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