dns_handler

Documentation

Index

• type DummyServerHandler
  • func (d *DummyServerHandler) ServeDNS(_ context.Context, req *dns.Msg, meta *query_context.RequestMeta) (*dns.Msg, error)
• type EntryHandler
  • func NewEntryHandler(opts EntryHandlerOpts) (*EntryHandler, error)
  • func (h *EntryHandler) ServeDNS(ctx context.Context, req *dns.Msg, meta *query_context.RequestMeta) (*dns.Msg, error)
• type EntryHandlerOpts
  • func (opts *EntryHandlerOpts) Init() error
• type Handler

Types

type DummyServerHandler

type DummyServerHandler struct {
	T       *testing.T
	WantMsg *dns.Msg
	WantErr error
}

func (*DummyServerHandler) ServeDNS

func (d *DummyServerHandler) ServeDNS(_ context.Context, req *dns.Msg, meta *query_context.RequestMeta) (*dns.Msg, error)

type EntryHandler

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

func NewEntryHandler

func NewEntryHandler(opts EntryHandlerOpts) (*EntryHandler, error)

func (*EntryHandler) ServeDNS

func (h *EntryHandler) ServeDNS(ctx context.Context, req *dns.Msg, meta *query_context.RequestMeta) (*dns.Msg, error)

ServeDNS implements Handler. If entry returns an error, a SERVFAIL response will be returned. If entry returns without a response, a REFUSED response will be returned.

type EntryHandlerOpts

type EntryHandlerOpts struct {
	// Logger is used for logging. Default is a noop logger.
	Logger *zap.Logger

	Entry executable_seq.Executable

	// QueryTimeout limits the timeout value of each query.
	// Default is defaultQueryTimeout.
	QueryTimeout time.Duration

	// RecursionAvailable sets the dns.Msg.RecursionAvailable flag globally.
	RecursionAvailable bool
}

func (*EntryHandlerOpts) Init

func (opts *EntryHandlerOpts) Init() error

type Handler

type Handler interface {
	// ServeDNS handles incoming request req and returns a response.
	// Implements must not keep and use req after the ServeDNS returned.
	// ServeDNS should handle dns errors by itself and return a proper error responses
	// for clients.
	// ServeDNS should always return a responses.
	// If ServeDNS returns an error, caller considers that the error is associated
	// with the downstream connection and will close the downstream connection
	// immediately.
	// All input parameters won't be nil.
	ServeDNS(ctx context.Context, req *dns.Msg, meta *query_context.RequestMeta) (*dns.Msg, error)
}

Handler handles dns query.