chaos

README

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

Documentation

Overview

Package chaos implements a middleware that answer to 'CH version.bind TXT' type queries.

Index

• type Chaos
  • func (c Chaos) Name() string
  • func (c Chaos) ServeDNS(ctx context.Context, w dns.ResponseWriter, r *dns.Msg) (int, error)

Types

type Chaos

type Chaos struct {
	Next    middleware.Handler
	Version string
	Authors map[string]bool
}

Chaos allows CoreDNS to reply to CH TXT queries and return author or version information.

func (Chaos) Name

func (c Chaos) Name() string

Name implements the Handler interface.

func (Chaos) ServeDNS

func (c Chaos) ServeDNS(ctx context.Context, w dns.ResponseWriter, r *dns.Msg) (int, error)

ServeDNS implements the middleware.Handler interface.