proxy

Documentation

Index

• type Proxy
  • func (p Proxy) ListenAndServe(ctx context.Context) error
  • func (p Proxy) Resolve(ctx context.Context, q resolver.Query, buf []byte) (n int, err error)
• type QueryInfo

Types

type Proxy

type Proxy struct {
	// Addr specifies the TCP/UDP address to listen to, :53 if empty.
	Addr string

	// Upstream specifies the resolver used for incoming queries.
	Upstream resolver.Resolver

	// BogusPriv specifies that reverse lookup on private subnets are answerd
	// with NXDOMAIN.
	BogusPriv bool

	// Timeout defines the maximum allowed time allowed for a request before
	// being cancelled.
	Timeout time.Duration

	// QueryLog specifies an optional log function called for each received query.
	QueryLog func(QueryInfo)

	// ErrorLog specifies an optional log function for errors. If not set,
	// errors are not reported.
	ErrorLog func(error)
}

Proxy is a DNS53 to DNS over anything proxy.

func (Proxy) ListenAndServe

func (p Proxy) ListenAndServe(ctx context.Context) error

ListenAndServe listens on UDP and TCP and serve DNS queries. If ctx is canceled, listeners are closed and ListenAndServe returns context.Canceled error.

func (Proxy) Resolve

func (p Proxy) Resolve(ctx context.Context, q resolver.Query, buf []byte) (n int, err error)

type QueryInfo

type QueryInfo struct {
	Protocol     string
	PeerIP       net.IP
	Type         string
	Name         string
	QuerySize    int
	ResponseSize int
	Duration     time.Duration
}

QueryInfo provides information about a DNS query handled by Proxy.