plugin/debug/README.md

# debug

*debug* disables the automatic recovery upon a CoreDNS crash so that you'll get a nice stack trace.

Note that the *errors* plugin (if loaded) will also set a `recover` negating this setting.
The main use of *debug* is to help testing.

## Syntax

~~~ txt
debug
~~~

## Examples

Disable CoreDNS' ability to recover from crashes:

~~~ txt
debug
~~~
middleware/debug: add (#735) * middleware/debug: add Add a debug "middleware" that disables the recover() and just lets CoreDNS crash; very useful for testing. Fixes ##563 * fix test * Feedback: check the value of Debug 2017-06-13 15:47:17 -07:00			`# debug`

Fix all READMEs and some other fluff (#788) 2017-07-24 08:24:53 -07:00			`debug disables the automatic recovery upon a CoreDNS crash so that you'll get a nice stack trace.`

Remove the word middleware (#1067) * Rename middleware to plugin first pass; mostly used 'sed', few spots where I manually changed text. This still builds a coredns binary. * fmt error * Rename AddMiddleware to AddPlugin * Readd AddMiddleware to remain backwards compat 2017-09-14 09:36:06 +01:00			Note that the errors plugin (if loaded) will also set a `recover` negating this setting.
middleware/debug: add (#735) * middleware/debug: add Add a debug "middleware" that disables the recover() and just lets CoreDNS crash; very useful for testing. Fixes ##563 * fix test * Feedback: check the value of Debug 2017-06-13 15:47:17 -07:00			`The main use of debug is to help testing.`

			`## Syntax`

			`~~~ txt`
			`debug`
			`~~~`

			`## Examples`

			`Disable CoreDNS' ability to recover from crashes:`

			`~~~ txt`
			`debug`
			`~~~`