doh

Documentation

Index

• Variables
• type Dialer
  • func New(settings Settings) (dial *Dialer, err error)
  • func (d *Dialer) Dial(ctx context.Context, _, _ string) (conn net.Conn, err error)
  • func (d *Dialer) String() string
• type Metrics
• type Settings
  • func (s *Settings) SetDefaults()
  • func (s *Settings) String() string
  • func (s *Settings) ToLinesNode() (node *gotree.Node)
  • func (s Settings) Validate() (err error)

Variables

var ErrHTTPStatus = errors.New("bad HTTP status")

var ErrUpstreamResolversNotSet = errors.New("upstream resolvers not set")

Types

type Dialer

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

func New

func New(settings Settings) (dial *Dialer, err error)

func (*Dialer) Dial

func (d *Dialer) Dial(ctx context.Context, _, _ string) (
	conn net.Conn, err error,
)

func (*Dialer) String

func (d *Dialer) String() string

type Metrics

type Metrics interface {
	DoHDialInc(url string)
}

type Settings

type Settings struct {
	// UpstreamResolvers is a list of DNS over TLS upstream resolvers
	// to use.
	UpstreamResolvers []provider.Provider
	// Timeout is the maximum duration to wait for a response from
	// upstream DNS over HTTPS servers. If left unset, it defaults to
	// 5 seconds.
	Timeout time.Duration
	// IPVersion indicates whether to use IPv4 only or IPv6 only for
	// DNS over HTTPS. The hardcoded resolver used by the DoH HTTP
	// client will return only IP addresses matching the version set
	// from all the providers. If left unset, it defaults to "ipv4".
	IPVersion string
	// Metrics is the metrics interface to record metric data.
	// It defaults to a No-Op metrics implementation.
	Metrics Metrics
}

func (*Settings) SetDefaults

func (s *Settings) SetDefaults()

func (*Settings) String

func (s *Settings) String() string

func (*Settings) ToLinesNode

func (s *Settings) ToLinesNode() (node *gotree.Node)

func (Settings) Validate

func (s Settings) Validate() (err error)