dnsx

type Answer ¶

type Answer struct {
	Name string `json:"name"`
	Type string `json:"type"`
	TTL  uint32 `json:"ttl"`
}

Answer represents a DNS answer.

type Handler ¶

type Handler interface {
	ServeDNS(context.Context, dns.ResponseWriter, *dns.Msg)
}

func ChainHandler(set RecordGetter, next Handler) Handler

func NotifyHandler(notify NofitifyFunc, next Handler) Handler

func RecordSetHandler(set RecordGetter) Handler

type HandlerFunc ¶

type HandlerFunc func(context.Context, dns.ResponseWriter, *dns.Msg)

func (f HandlerFunc) ServeDNS(ctx context.Context, w dns.ResponseWriter, r *dns.Msg)

type HandlerProvider ¶

type HandlerProvider interface {
	Handler
	challenge.Provider
}

func ChallengeHandler(next Handler) HandlerProvider

type Meta ¶

type Meta struct {
	Question Question `json:"question"`
	Answer   []Answer `json:"answer,omitempty"`
}

Meta contains DNS-specific event metadata.

type NofitifyFunc ¶

type NofitifyFunc func(
	ctx context.Context,
	remoteAddr net.Addr,
	receivedAt *time.Time,
	read []byte,
	written []byte,
	combined []byte,
	meta *Meta,
)

type Option ¶

type Option func(*options)

func NotifyStartedFunc(f func()) Option

type Question ¶

type Question struct {
	Name string `json:"name"`
	Type string `json:"type"`
}

Question represents a DNS question.

type RecordGetter ¶

type RecordGetter interface {
	Get(ctx context.Context, name string, qtype uint16) ([]dns.RR, error)
}

RecordGetter is an interface which must be implemented by any records providers like database records, in-memory records, etc.

type Recorder ¶

type Recorder struct {
	dns.ResponseWriter
	Rcode int
	Len   int
	Msg   *dns.Msg
	Start time.Time
}

Recorder is a type of dns.ResponseWriter that captures the rcode code written to it and also the size of the message written in the response. A rcode code does not have to be written, however, in which case 0 must be assumed. It is best to have the constructor initialize this type with that default status code.

func NewRecorder(w dns.ResponseWriter) *Recorder

func (r *Recorder) Write(buf []byte) (int, error)

func (r *Recorder) WriteMsg(res *dns.Msg) error

type Records ¶

type Records struct {
	// contains filtered or unexported fields
}

Records represents in memory stored DNS records.

func NewRecords(rrs []dns.RR) *Records

func (r *Records) Add(rr dns.RR)

func (r *Records) Del(name string, qtype uint16) error

func (r *Records) Get(ctx context.Context, name string, qtype uint16) ([]dns.RR, error)

type ServeMux ¶

type ServeMux struct {
	// contains filtered or unexported fields
}

func NewServeMux() *ServeMux

func (mux *ServeMux) Handle(pattern string, handler Handler)

func (mux *ServeMux) HandleFunc(pattern string, handler func(context.Context, dns.ResponseWriter, *dns.Msg))

func (mux *ServeMux) ServeDNS(ctx context.Context, w dns.ResponseWriter, req *dns.Msg)

type Server ¶

type Server interface {
	ListenAndServe() error
}

func New(addr string, h Handler, opts ...Option) Server