resolver

Jan 23, 2024

Changes in this version

+ const DefaultIteratorAttempts

+ const DefaultIteratorDeadline

+ const DefaultIteratorInterval

type IteratorLookuper

+ func (r *IteratorLookuper) SetResilience(attempts int, deadline, interval time.Duration)

type NSCacheZone

+ func (zone *NSCacheZone) Exchange(ctx context.Context, req *dns.Msg) (*dns.Msg, error)

+ func (zone *NSCacheZone) ExchangeWithClient(ctx context.Context, req *dns.Msg, c client.Client) (*dns.Msg, error)

+ func (zone *NSCacheZone) SetResilience(attempts int, deadline, interval time.Duration)

Jan 18, 2024

Changes in this version

+ type Pool struct

+ Attempts int

+ Deadline time.Duration

+ Interval time.Duration

+ func NewPoolExchanger(c client.Client, servers ...string) (*Pool, error)

+ func (p *Pool) Add(servers ...string) error

+ func (p *Pool) Exchange(ctx context.Context, req *dns.Msg) (*dns.Msg, error)

+ func (p *Pool) ExchangeWithClient(ctx context.Context, req *dns.Msg, c client.Client) (*dns.Msg, error)

+ func (p *Pool) ForEach(fn func(string) bool)

+ func (p *Pool) Len() int

+ func (p *Pool) Lookup(ctx context.Context, qName string, qType uint16) (*dns.Msg, error)

+ func (p *Pool) Remove(servers ...string) error

+ func (p *Pool) Server() string

+ func (p *Pool) Servers() []string

Jan 11, 2024

Changes in this version

+ type IteratorLookuper struct

+ func NewIteratorLookuper(name string, maxRR uint, c client.Client) *IteratorLookuper

+ func (r *IteratorLookuper) AddFrom(qName string, ttl uint32, server ...string) error

+ func (r *IteratorLookuper) AddMap(qName string, ttl uint32, servers map[string]string) error

+ func (r *IteratorLookuper) AddMapPersistent(qName string, ttl uint32, servers map[string]string) error

+ func (r *IteratorLookuper) AddRootServers() error

+ func (r *IteratorLookuper) AddServer(qName string, ttl uint32, servers ...string) error

+ func (r *IteratorLookuper) DisableAAAA()

+ func (r *IteratorLookuper) Exchange(ctx context.Context, req *dns.Msg) (*dns.Msg, error)

+ func (r *IteratorLookuper) Lookup(ctx context.Context, name string, qType uint16) (*dns.Msg, error)

+ func (r *IteratorLookuper) ParseAddr(server string) (netip.Addr, bool, error)

+ func (r *IteratorLookuper) ParseAddrs(servers []string) ([]netip.Addr, error)

+ func (r *IteratorLookuper) SetLogger(log slog.Logger)

+ func (r *IteratorLookuper) SetPersistent(qName string) error

type NSCache

+ func (nsc *NSCache) Evict(name string)

type NSCacheZone

+ func NewNSCacheZoneFromNS(resp *dns.Msg) (*NSCacheZone, error)

+ func (zone *NSCacheZone) HasGlue() bool

+ func (zone *NSCacheZone) ReplyNS(req *dns.Msg) *dns.Msg

type RootLookuper

+ func (r RootLookuper) DisableAAAA()

Jan 11, 2024

Changes in this version

+ const DefaultNSCacheSize

+ type NSCache struct

+ func NewNSCache(name string, maxRR uint) *NSCache

+ func (*NSCache) Suffixes(qName string) []string

+ func (nsc *NSCache) Add(zone *NSCacheZone) error

+ func (nsc *NSCache) AddMap(name string, ttl uint32, m map[string]string) error

+ func (nsc *NSCache) Exchange(ctx context.Context, req *dns.Msg) (*dns.Msg, error)

+ func (nsc *NSCache) ExchangeWithClient(ctx context.Context, req *dns.Msg, c client.Client) (*dns.Msg, error)

+ func (nsc *NSCache) Get(qName string) (*NSCacheZone, time.Time, bool)

+ func (nsc *NSCache) Lookup(qName string) (*NSCacheZone, bool)

+ func (nsc *NSCache) SetLogger(log slog.Logger)

+ func (nsc *NSCache) SetPersistence(qName string, persistent bool) error

Jan 10, 2024

Changes in this version

+ func DefaultSingleFlightHasher(_ context.Context, req *dns.Msg) (string, error)

+ type SingleFlight struct

+ func NewSingleFlight(next Exchanger, exp time.Duration, hasher SingleFlightHasher) (*SingleFlight, error)

+ func (sf *SingleFlight) Exchange(ctx context.Context, req *dns.Msg) (*dns.Msg, error)

+ func (sf *SingleFlight) Lookup(ctx context.Context, qName string, qType uint16) (*dns.Msg, error)

+ type SingleFlightHasher func(context.Context, *dns.Msg) (string, error)

Jan 10, 2024

Changes in this version

+ const MinimumNSCacheTTL

+ type NSCacheZone struct

+ func NewNSCacheZone(name string) *NSCacheZone

+ func NewNSCacheZoneFromDelegation(resp *dns.Msg) (*NSCacheZone, error)

+ func NewNSCacheZoneFromMap(name string, ttl uint32, m map[string]string) *NSCacheZone

+ func (zone *NSCacheZone) AddGlue(name string, addrs ...netip.Addr) bool

+ func (zone *NSCacheZone) AddGlueNS(name string, addrs ...netip.Addr) bool

+ func (zone *NSCacheZone) AddGlueRR(rr dns.RR) bool

+ func (zone *NSCacheZone) AddNS(name string) bool

+ func (zone *NSCacheZone) Addrs() []string

+ func (zone *NSCacheZone) Expire() time.Time

+ func (zone *NSCacheZone) ExportGlue() []dns.RR

+ func (zone *NSCacheZone) ExportNS() []dns.RR

+ func (zone *NSCacheZone) ForEachAddr(fn func(string) bool)

+ func (zone *NSCacheZone) ForEachNS(fn func(name string, addrs []netip.Addr))

+ func (zone *NSCacheZone) Index()

+ func (zone *NSCacheZone) IsValid() bool

+ func (zone *NSCacheZone) Len() int

+ func (zone *NSCacheZone) Name() string

+ func (zone *NSCacheZone) NeedsRefresh() bool

+ func (zone *NSCacheZone) OriginalTTL() uint32

+ func (zone *NSCacheZone) RandomAddrs() []string

+ func (zone *NSCacheZone) Server() string

+ func (zone *NSCacheZone) Servers() []string

+ func (zone *NSCacheZone) SetGlue(name string, addrs []netip.Addr) bool

+ func (zone *NSCacheZone) SetTTL(ttl, half uint32)

+ func (zone *NSCacheZone) TTL() uint32

Dec 13, 2023

Changes in this version

+ func HasAnswerType(msg *dns.Msg, qType uint16) bool

+ func HasNsType(msg *dns.Msg, qType uint16) bool

Dec 11, 2023

Changes in this version

type RootLookuper

+ func NewRootLookuperWithClient(start string, c client.Client) (*RootLookuper, error)

type SingleLookuper

+ func NewSingleLookuperWithClient(server string, recursive bool, c client.Client) (*SingleLookuper, error)

Dec 6, 2023

Changes in this version

+ func GetFirstAnswer[T dns.RR](msg *dns.Msg) T

type RootLookuper

+ func (r RootLookuper) IterateMsg(ctx context.Context, req *dns.Msg, startAt string) (*dns.Msg, error)

Dec 4, 2023

Changes in this version

+ type ExchangerFunc func(context.Context, *dns.Msg) (*dns.Msg, error)

+ func (fn ExchangerFunc) Exchange(ctx context.Context, msg *dns.Msg) (*dns.Msg, error)

+ func (fn ExchangerFunc) Lookup(ctx context.Context, qName string, qType uint16) (*dns.Msg, error)

+ type LookuperFunc func(context.Context, string, uint16) (*dns.Msg, error)

+ func (fn LookuperFunc) Exchange(ctx context.Context, msg *dns.Msg) (*dns.Msg, error)

+ func (fn LookuperFunc) Lookup(ctx context.Context, qName string, qType uint16) (*dns.Msg, error)

Nov 30, 2023

Changes in this version

+ type Exchanger interface

+ Exchange func(ctx context.Context, q *dns.Msg) (*dns.Msg, error)

type RootLookuper

+ func (r RootLookuper) ExchangeWithServer(ctx context.Context, m *dns.Msg, server string) (*dns.Msg, error)

Apr 26, 2023

Changes in this version

type LookupResolver

+ func NewRootResolver(start string) (*LookupResolver, error)

Apr 26, 2023

Changes in this version

+ func ErrBadResponse() *net.DNSError

+ func ErrNotImplemented(name string) *net.DNSError

Apr 25, 2023

Changes in this version

+ func Decanonize(qname string) string

+ func ErrNotFound(qName string) *net.DNSError

+ func ErrTimeout(qName string, err error) *net.DNSError

+ func ErrTimeoutMessage(qName string, msg string) *net.DNSError

+ func IsNotFound(err error) bool

+ func IsTemporary(err error) bool

+ func IsTimeout(err error) bool

Apr 7, 2023

Changes in this version

type RootLookuper

+ func (r RootLookuper) Exchange(ctx context.Context, m *dns.Msg, server string) (*dns.Msg, error)

+ func (r RootLookuper) Iterate(ctx context.Context, name string, qtype uint16, startAt string) (*dns.Msg, error)

Apr 7, 2023

Changes in this version

+ const DefaultUDPSize

+ func AsServerAddress(server string) (string, error)

+ type MultiLookuper struct

+ func NewMultiLookuper(lookupers ...Lookuper) *MultiLookuper

+ func NewMultiLookuperAddresses(servers ...string) (*MultiLookuper, error)

+ func (r MultiLookuper) Lookup(ctx context.Context, qName string, qType uint16) (*dns.Msg, error)

+ type SingleLookuper struct

+ func NewCloudflareLookuper() *SingleLookuper

+ func NewGoogleLookuper() *SingleLookuper

+ func NewGoogleLookuper2() *SingleLookuper

+ func NewQuad9Lookuper() *SingleLookuper

+ func NewQuad9Lookuper6() *SingleLookuper

+ func NewSingleLookuper(server string) (*SingleLookuper, error)

+ func (r SingleLookuper) Exchange(ctx context.Context, msg *dns.Msg) (*dns.Msg, error)

+ func (r SingleLookuper) Lookup(ctx context.Context, qName string, qType uint16) (*dns.Msg, error)

Apr 7, 2023

Changes in this version

+ func ForEachAnswer(msg *dns.Msg, fn func(v T))

Apr 7, 2023

Changes in this version

type RootLookuper

+ func NewRootLookuper(start string) (*RootLookuper, error)

Apr 6, 2023

Changes in this version

+ type RootLookuper struct

+ Start string

+ func (r RootLookuper) Lookup(ctx context.Context, qName string, qType uint16) (*dns.Msg, error)

Apr 6, 2023

Changes in this version

+ func SystemResolver(preferGo bool) *net.Resolver

+ func SystemResolverWithDialer(preferGo bool, dialer DialerFunc) *net.Resolver

+ type DialerFunc func(ctx context.Context, network, address string) (net.Conn, error)

+ type LookupResolver struct

+ func NewResolver(h Lookuper) *LookupResolver

+ func (LookupResolver) LookupAddr(_ context.Context, _ string) ([]string, error)

+ func (LookupResolver) LookupCNAME(_ context.Context, _ string) (string, error)

+ func (LookupResolver) LookupHost(_ context.Context, _ string) (addrs []string, err error)

+ func (LookupResolver) LookupIP(_ context.Context, _, _ string) ([]net.IP, error)

+ func (LookupResolver) LookupIPAddr(_ context.Context, _ string) ([]net.IPAddr, error)

+ func (LookupResolver) LookupMX(_ context.Context, _ string) ([]*net.MX, error)

+ func (LookupResolver) LookupNS(_ context.Context, _ string) ([]*net.NS, error)

+ func (LookupResolver) LookupNetIP(_ context.Context, _, _ string) ([]netip.Addr, error)

+ func (LookupResolver) LookupSRV(_ context.Context, _, _, _ string) (cname string, addrs []*net.SRV, err error)

+ func (LookupResolver) LookupTXT(_ context.Context, _ string) ([]string, error)

+ type Lookuper interface

+ Lookup func(ctx context.Context, qName string, qType uint16) (*dns.Msg, error)

+ type Resolver interface

+ LookupAddr func(ctx context.Context, addr string) ([]string, error)

+ LookupCNAME func(ctx context.Context, host string) (string, error)

+ LookupHost func(ctx context.Context, host string) (addrs []string, err error)

+ LookupIP func(ctx context.Context, network, host string) ([]net.IP, error)

+ LookupIPAddr func(ctx context.Context, host string) ([]net.IPAddr, error)

+ LookupMX func(ctx context.Context, name string) ([]*net.MX, error)

+ LookupNS func(ctx context.Context, name string) ([]*net.NS, error)

+ LookupNetIP func(ctx context.Context, network, host string) ([]netip.Addr, error)

+ LookupSRV func(ctx context.Context, service, proto, name string) (cname string, addrs []*net.SRV, err error)

+ LookupTXT func(ctx context.Context, name string) ([]string, error)

+ type ZeroLookuper struct

+ func (ZeroLookuper) Lookup(_ context.Context, _ string, _ uint16) (*dns.Msg, error)

Apr 6, 2023

Changes in this version

+ func Iterate(ctx context.Context, name string, qtype uint16, startAt string) (*dns.Msg, error)