middleware/chaos/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` the version to return. Defaults to CoreDNS-<version>, if not set.
* `authors` 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

~~~
chaos CoreDNS-001 "Miek Gieben" miek@miek.nl
~~~
Implement chaos middleware This allows for CH TXT queries that return some information about the server and/or the authors (or whatever you put in there). 2016-03-24 17:58:31 +00:00			`# chaos`

Update README.md Grammatical fixes. 2016-08-22 13:53:00 -07:00			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.`
Implement chaos middleware This allows for CH TXT queries that return some information about the server and/or the authors (or whatever you put in there). 2016-03-24 17:58:31 +00:00
			`## Syntax`

			`~~~`
			`chaos [version] [authors...]`
			`~~~`

Update README.md Grammatical fixes. 2016-08-22 13:53:00 -07:00			* `version` the version to return. Defaults to CoreDNS-<version>, if not set.
Implement chaos middleware This allows for CH TXT queries that return some information about the server and/or the authors (or whatever you put in there). 2016-03-24 17:58:31 +00:00			* `authors` what authors to return. No default.

Fix stubzone retention (#198) Make the receiver a pointer so that the uptdateStubZones map update will retain the stubzones found, unlike the current case where the update will be applied and then promptly forgotten, because it is working on a copy. Add test/etcd_test.go to test a large part of the code. This didn't catch the chaos middleware hack though. The chaos middleware zones are now not automatically added. You have to take care of that by yourself (docs updates). When using debug queries and falling through to the next middleware in etcd, restore the original (with o-o.debug) query before passing it on. 2016-08-08 19:18:55 -07:00			`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`.
Cleanup docs and the chaos middleware Make the CH middleware actually work. Needs a bit of a hack to route the fake version.bind and friends zone to the correct handler. Fiddle with the order in directive.go so that CH queries get logged as well. Secondly add class rewriting to the rewrite middleware handler and also log the class by default. 2016-04-04 15:45:17 +01:00
Implement chaos middleware This allows for CH TXT queries that return some information about the server and/or the authors (or whatever you put in there). 2016-03-24 17:58:31 +00:00			`## Examples`

			`~~~`
Cleanup docs and the chaos middleware Make the CH middleware actually work. Needs a bit of a hack to route the fake version.bind and friends zone to the correct handler. Fiddle with the order in directive.go so that CH queries get logged as well. Secondly add class rewriting to the rewrite middleware handler and also log the class by default. 2016-04-04 15:45:17 +01:00			`chaos CoreDNS-001 "Miek Gieben" miek@miek.nl`
Implement chaos middleware This allows for CH TXT queries that return some information about the server and/or the authors (or whatever you put in there). 2016-03-24 17:58:31 +00:00			`~~~`