resolver

Documentation

Overview

Package resolver provides a caching, non-blocking DNS resolver. All requests for cached resources are returned immediately and if cache has expired, an offline goroutine is fired to update it.

Package resolver provides a caching, non-blocking DNS resolver. All requests for cached resources are returned immediately and if cache has expired, an offline goroutine is fired to update it.

Index

• Constants
• func New(opts ...Option) *resolverImpl
• func ParseOverrideAddress(dnsResolverOverride string) (string, string, error)
• type Option
  • func GetResolverOptions(targetsDef *targetspb.TargetsDef, l *logger.Logger) ([]Option, error)
  • func WithDNSServer(serverNetworkOverride, serverAddressOverride string) Option
  • func WithLogger(l *logger.Logger) Option
  • func WithMaxTTL(ttl time.Duration) Option
  • func WithResolveFunc(resolveFunc func(context.Context, string, string) ([]net.IP, error)) Option
  • func WithResolveTimeout(resolveTimeout time.Duration) Option
  • func WithTTL(ttl time.Duration) Option
• type Resolver

Constants

const (
	IP  ipVersion = 0
	IP4 ipVersion = 4
	IP6 ipVersion = 6
)

Functions

func New

func New(opts ...Option) *resolverImpl

New returns a new Resolver.

func ParseOverrideAddress

func ParseOverrideAddress(dnsResolverOverride string) (string, string, error)

Types

type Option

type Option func(*resolverImpl)

func GetResolverOptions

func GetResolverOptions(targetsDef *targetspb.TargetsDef, l *logger.Logger) ([]Option, error)

func WithDNSServer

func WithDNSServer(serverNetworkOverride, serverAddressOverride string) Option

func WithLogger

func WithLogger(l *logger.Logger) Option

func WithMaxTTL

func WithMaxTTL(ttl time.Duration) Option

func WithResolveFunc

func WithResolveFunc(resolveFunc func(context.Context, string, string) ([]net.IP, error)) Option

func WithResolveTimeout

func WithResolveTimeout(resolveTimeout time.Duration) Option

func WithTTL

func WithTTL(ttl time.Duration) Option

type Resolver

type Resolver interface {
	Resolve(name string, ipVer int) (net.IP, error)
}