plain

Documentation

Index

• Variables
• type Dialer
  • func New(settings Settings) (dial *Dialer, err error)
  • func (d *Dialer) Dial(ctx context.Context, network, _ 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)
• type Warner

Variables

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, network, _ string) (
	conn net.Conn, err error,
)

func (*Dialer) String

func (d *Dialer) String() string

type Metrics

type Metrics interface {
	PlainDialInc(address, outcome string)
}

type Settings

type Settings struct {
	// UpstreamResolvers is a list of plain DNS upstream resolvers
	// to use.
	UpstreamResolvers []provider.Provider
	// Timeout is the maximum duration to wait for a response from
	// upstream DNS servers. If left unset, it defaults to
	// 5 seconds.
	Timeout time.Duration
	// IPVersion defines the only IP version to use to connect to
	// upstream DNS servers. 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)

type Warner

type Warner interface {
	Warn(s string)
}