Commit 2cff9291 authored by Miek Gieben's avatar Miek Gieben Committed by GitHub

mw/whoami: update docs (#1054)

* mw/whoami: update docs

Parse the corefile in the readme_test.go and other tweaks to the docs.

Fixes #1049

* trailing

* remove the 53 port
parent 2785f01d
# whoami
*whoami* returns your local IP address, port and transport used. Your local IP address is returned in
the additional section as either an A or AAAA record.
*whoami* returns your resolver's local IP address, port and transport. Your IP address is returned
in the additional section as either an A or AAAA record.
The port and transport are included in the additional section as a SRV record, transport can be
"tcp" or "udp".
The reply always has an empty answer section. The port and transport are included in the additional
section as a SRV record, transport can be "tcp" or "udp".
~~~ txt
._<transport>.qname. 0 IN SRV 0 0 <port> .
~~~
If CoreDNS can't find a Corefile on startup this is the *default* middleware that gets loaded. As
such it can be used to check that CoreDNS is responding to queries. Other than that this middleware
is of limited use in production.
The *whoami* middleware will respond to every A or AAAA query, regardless of the query name.
## Syntax
......@@ -20,8 +24,10 @@ whoami
## Examples
~~~ txt
.:53 {
Start a server on the default port and load the *whoami* middleware.
~~~ corefile
. {
whoami
}
~~~
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment