whoami

README

whoami

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

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

whoami

Examples

Start a server on the default port and load the whoami middleware.

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

Documentation

Overview

Package whoami implements a middleware that returns details about the resolving querying it.

Index

• type Whoami
  • func (wh Whoami) Name() string
  • func (wh Whoami) ServeDNS(ctx context.Context, w dns.ResponseWriter, r *dns.Msg) (int, error)

Types

type Whoami

type Whoami struct{}

Whoami is a middleware that returns your IP address, port and the protocol used for connecting to CoreDNS.

func (Whoami) Name

func (wh Whoami) Name() string

Name implements the Handler interface.

func (Whoami) ServeDNS

func (wh Whoami) ServeDNS(ctx context.Context, w dns.ResponseWriter, r *dns.Msg) (int, error)

ServeDNS implements the middleware.Handler interface.