mirror of
https://github.com/coredns/coredns.git
synced 2025-11-02 02:03:13 -05:00
62317c3c14
Update all documentation in the tree to use example.org as an example configuration (in so far possible). As to get out of the just use "." and fallthrough and things would be fine. Signed-off-by: Miek Gieben <miek@miek.nl>
49 lines
1.3 KiB
Markdown
49 lines
1.3 KiB
Markdown
# debug
|
|
|
|
## Name
|
|
|
|
*debug* - disables the automatic recovery upon a crash so that you'll get a nice stack trace.
|
|
|
|
## Description
|
|
|
|
Normally CoreDNS will recover from panics; using *debug* inhibits this. The main use of *debug* is
|
|
to help in testing. A side effect of using *debug* is that `log.Debug` and `log.Debugf` messages
|
|
will be printed to standard output.
|
|
|
|
Note that the *errors* plugin (if loaded) will also set a `recover`, negating this setting.
|
|
|
|
## Syntax
|
|
|
|
~~~ txt
|
|
debug
|
|
~~~
|
|
|
|
Some plugins will send debug log DNS messages. This is done in the following format:
|
|
|
|
~~~
|
|
debug: 000000 00 0a 01 00 00 01 00 00 00 00 00 01 07 65 78 61
|
|
debug: 000010 6d 70 6c 65 05 6c 6f 63 61 6c 00 00 01 00 01 00
|
|
debug: 000020 00 29 10 00 00 00 80 00 00 00
|
|
debug: 00002a
|
|
~~~
|
|
|
|
Using `text2pcap` (part of Wireshark), this can be converted back to binary, with the following
|
|
command line: `text2pcap -i 17 -u 53,53`, where 17 is the protocol (UDP) and 53 are the ports. These
|
|
ports allow Wireshark to detect these packets as DNS messages.
|
|
|
|
Each plugin can decide whether to dump messages to aid in debugging.
|
|
|
|
## Examples
|
|
|
|
Disable the ability to recover from crashes and show debug logging:
|
|
|
|
~~~ corefile
|
|
. {
|
|
debug
|
|
}
|
|
~~~
|
|
|
|
## Also See
|
|
|
|
<https://www.wireshark.org/docs/man-pages/text2pcap.html>.
|