Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
COREDNS-WHOAMI(7)		CoreDNS	Plugins		     COREDNS-WHOAMI(7)

NAME
       whoami -	returns	your resolver's	local IP address, port and transport.

DESCRIPTION
       The whoami plugin is not	really that useful, but	can be used for	having
       a simple	(fast) endpoint	to test	clients	against. When whoami returns a
       response	 it  will have your client's IP	address	in the additional sec-
       tion as either an A or AAAA record.

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

	      ._<transport>.qname. 0 IN	SRV 0 0	<port> .

       The whoami plugin will respond to every A or AAAA query,	regardless  of
       the query name.

       If  CoreDNS can't find a	Corefile on startup this is the	default	plugin
       that gets loaded. As such it can	be used	to check that CoreDNS  is  re-
       sponding	 to  queries. Other than that this plugin is of	limited	use in
       production.

SYNTAX
	      whoami

EXAMPLES
       Start a server on the default port and load the whoami plugin.

	      example.org {
		  whoami
	      }

       When queried for	"example.org A", CoreDNS will respond with:

	      ;; QUESTION SECTION:
	      ;example.org.   IN       A

	      ;; ADDITIONAL SECTION:
	      example.org.	      0	      IN      A	      10.240.0.1
	      _udp.example.org.	      0	      IN      SRV     0	0 40212

SEE ALSO
       Read the	blog  post  <https://coredns.io/2017/03/01/how-to-add-plugins-
       to-coredns/>  on	 how  this plugin is built, or explore the source code
       <https://github.com/coredns/coredns/blob/master/plugin/whoami/>.

CoreDNS				  March	2021		     COREDNS-WHOAMI(7)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=coredns-whoami&sektion=7&manpath=FreeBSD+Ports+14.3.quarterly>

home | help