recursive

Dec 11, 2025

Changes in this version

+ type CachedNetError struct

+ Address netip.Addr

+ Err error

+ Protocol string

+ When time.Time

+ func (ne *CachedNetError) Error() string

+ func (ne *CachedNetError) Unwrap() error

Dec 10, 2025

Changes in this version

+ var ErrInvalidCacheEntry = errors.New("invalid cache entry")

+ var ErrMismatchedQuestion = errors.New("mismatched response question")

Dec 9, 2025

Changes in this version

type Cache

+ func (cache *Cache) CleanAllow(t time.Time, allowfn func(msg *dns.Msg, stale bool) bool)

Dec 2, 2025

Changes in this version

type Cache

+ func (cache *Cache) WriteToV1(w io.Writer) (n int64, err error)

Nov 4, 2025

Changes in this version

+ var ErrBadRecord = errors.New("bad record")

Nov 4, 2025

Changes in this version

+ var ErrWrongMagic = errors.New("wrong magic number")

Nov 4, 2025

Changes in this version

type Cache

+ func (cache *Cache) CleanBefore(t time.Time)

+ func (cache *Cache) ReadFrom(r io.Reader) (n int64, err error)

+ func (cache *Cache) WriteTo(w io.Writer) (n int64, err error)

Nov 4, 2025

Changes in this version

type Cache

+ func (cache *Cache) Merge(other *Cache)

Nov 4, 2025

Changes in this version

type Cache

+ func (cache *Cache) Clone() (clone *Cache)

Nov 3, 2025

Changes in this version

type Cache

+ AllowStale atomic.Bool

Nov 3, 2025

Changes in this version

type Cache

+ func (cache *Cache) Walk(fn func(msg *dns.Msg, expires time.Time) (err error)) (err error)

Oct 13, 2025

Changes in this version

+ var DefaultMsgSize uint16 = 1232

type Recursive

+ MsgSize uint16

Oct 1, 2025

Changes in this version

type Recursive

+ Deterministic bool

Oct 1, 2025

Changes in this version

type Recursive

+ func (r *Recursive) OrderRootsTimeout(ctx context.Context, cutoff time.Duration)

Sep 23, 2025

Changes in this version

+ var ErrExtendedErrorCode = extendedErrorCodeError(0)

+ func ErrorFromExtendedErrorCode(code uint16) (err error)

+ func ExtendedErrorCodeFromError(err error) (rcode uint16)

Sep 17, 2025

Changes in this version

+ var DefaultDNSPort uint16 = 53

type Recursive

+ DNSPort uint16

+ RecordFn func(rec *Recursive, nsaddr netip.Addr, qtype uint16, qname string, m *dns.Msg, ...)

Sep 10, 2025

Changes in this version

+ var ErrMaxSteps = fmt.Errorf("resolve steps exceeded %d", maxSteps)

Apr 11, 2025

Changes in this version

+ const DefaultNXTTL

type Cache

+ NXTTL int

Apr 9, 2025

Changes in this version

+ var DefaultTimeout = time.Second * 5

+ var ErrQuestionMismatch = errors.New("question mismatch")

type Recursive

+ Timeout time.Duration

Mar 28, 2025

Changes in this version

type Recursive

+ NoMini bool

May 16, 2024

Changes in this version

type Recursive

+ DefaultLogWriter io.Writer

Apr 24, 2024

Changes in this version

type Recursive

+ func (r *Recursive) GetRoots() (root4, root6 []netip.Addr)

Apr 24, 2024

Changes in this version

type Recursive

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

+ func (std *Recursive) LookupIP(ctx context.Context, network, host string) (ips []net.IP, err error)

+ func (std *Recursive) LookupIPAddr(ctx context.Context, host string) (addrs []net.IPAddr, err error)

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

+ func (std *Recursive) LookupNetIP(ctx context.Context, network, host string) (addrs []netip.Addr, err error)

Dec 14, 2023

Changes in this version

+ var ErrCyclic = errors.New("cyclic search")

Dec 12, 2023

Changes in this version

type Recursive

+ func (r *Recursive) ResetCookies()

Dec 5, 2023

Changes in this version

+ var ErrInvalidCookie = errors.New("invalid cookie")

Dec 4, 2023

Changes in this version

+ const MaxQtype

type Cache

+ func (cache *Cache) DnsGet(nsaddr netip.Addr, qname string, qtype uint16) (srv netip.Addr, msg *dns.Msg)

+ func (cache *Cache) DnsResolve(ctx context.Context, qname string, qtype uint16) (msg *dns.Msg, srv netip.Addr, err error)

+ func (cache *Cache) DnsSet(nsaddr netip.Addr, msg *dns.Msg)

+ func (cache *Cache) Entries() (n int)

type Cacher

+ DnsGet func(nsaddr netip.Addr, qname string, qtype uint16) (netip.Addr, *dns.Msg)

+ DnsSet func(nsaddr netip.Addr, msg *dns.Msg)

+ type CachingResolver interface

type Recursive

+ func (r *Recursive) DnsResolve(ctx context.Context, qname string, qtype uint16) (msg *dns.Msg, srv netip.Addr, err error)

+ func (r *Recursive) OrderRoots(ctx context.Context, dialer proxy.ContextDialer)

type Resolver

+ DnsResolve func(ctx context.Context, qname string, qtype uint16) (msg *dns.Msg, srv netip.Addr, err error)

Dec 1, 2023

Changes in this version

+ type Recursive struct

+ Cache Cacher

+ func (r *Recursive) QueryCount() uint64

+ func (r *Recursive) Resolve(ctx context.Context, qname string, qtype uint16) (msg *dns.Msg, srv netip.Addr, err error)

+ func (r *Recursive) ResolveWithOptions(ctx context.Context, dialer proxy.ContextDialer, cache Cacher, logw io.Writer, ...) (*dns.Msg, netip.Addr, error)

Nov 30, 2023

Changes in this version

+ const DefaultMaxTTL

+ const DefaultMinTTL

type Cache

+ MaxTTL int

+ MinTTL int

Nov 30, 2023

Changes in this version

type Cache

+ func (cache *Cache) Clear()

+ type Cacher interface

+ Get func(nsaddr netip.Addr, qname string, qtype uint16) *dns.Msg

+ Set func(nsaddr netip.Addr, msg *dns.Msg)

Nov 29, 2023

Changes in this version

+ var DefaultCache = NewCache()

+ type Cache struct

+ func NewCache() *Cache

+ func (cache *Cache) Clean(now time.Time)

+ func (cache *Cache) Get(nsaddr netip.Addr, qname string, qtype uint16) *dns.Msg

+ func (cache *Cache) HitRatio() float64

+ func (cache *Cache) Set(nsaddr netip.Addr, qname string, qtype uint16, msg *dns.Msg)

+ func (cache *Cache) Size() (n int)

type Resolver

+ Cache *Cache

Nov 28, 2023

Changes in this version

+ var DefaultTcpQueryTimeout = 10 * time.Second

+ var DefaultUdpQueryTimeout = 5 * time.Second

type Resolver

+ TcpQueryTimeout time.Duration

+ UdpQueryTimeout time.Duration

+ func (r *Resolver) QueryCount() uint64

+ func (r *Resolver) ResolveWithOptions(ctx context.Context, dialer proxy.ContextDialer, logw io.Writer, qname string, ...) (*dns.Msg, netip.Addr, error)

Nov 27, 2023

Changes in this version

+ var TcpQueryTimeout = 10 * time.Second

Nov 27, 2023

Changes in this version

+ var ErrMaxDepth = fmt.Errorf("recursion depth exceeded %d", maxDepth)

+ var ErrNoResponse = errors.New("no authoritative response")

+ var Roots4 = []netip.Addr

+ var Roots6 = []netip.Addr

+ var UdpQueryTimeout = 5 * time.Second

+ func AddrFromRR(rr dns.RR) netip.Addr

+ func DnsTypeToString(qtype uint16) string

+ func MinTTL(msg *dns.Msg) int

+ type Resolver struct

+ func New() *Resolver

+ func NewWithOptions(dialer proxy.ContextDialer, roots4, roots6 []netip.Addr, ...) *Resolver

+ func (r *Resolver) CacheClean(now time.Time)

+ func (r *Resolver) CacheGet(nsaddr netip.Addr, qname string, qtype uint16) *dns.Msg

+ func (r *Resolver) CacheHitRatio() float64

+ func (r *Resolver) CacheSet(nsaddr netip.Addr, qname string, qtype uint16, msg *dns.Msg)

+ func (r *Resolver) CacheSize() (n int)

+ func (r *Resolver) Resolve(ctx context.Context, qname string, qtype uint16) (*dns.Msg, error)