Close shuts down the pool and closes all idle connections. After Close() is called, Get() will return net.ErrClosed and Put() will close connections

New creates a new Dialer with the given options. Default configuration: - Strategy: Race (lowest latency) - Timeout: 2 seconds per query - Logger: n

WithResolvers sets the DNS resolvers to query. Each address can be: - IP with port: "8.8.8.8:53" - IP without port: "8.8.8.8" (port 53 is assumed) -

WithStrategy sets the resolution strategy. Available strategies: - Race: Query all servers, return first successful response (minimize latency) - Fa

String returns a string representation of the record

recordsEqual checks if two slices of DNS records are equal, treating them as multisets. This means: - Order doesn't matter: [A, B] equals [B, A] - Du

WithCache enables DNS response caching with TTL-aware expiration. Caching reduces query latency for repeated lookups and load on DNS resolvers. The c

lookupIPs extracts IP addresses from DNS records.

Get retrieves a connection from the pool or creates a new one. This implements a lazy allocation strategy: connections are only created when needed,

DialContext implements the net.Dialer.DialContext signature, making it a drop-in replacement for any Go code that accepts a custom dialer. Use with H

getSystemResolver attempts to read the system's DNS resolver from /etc/resolv.conf. Returns the first nameserver found, with :53 appended if no port i

Name returns the identifier of this resolver (typically the server address). Used for logging and in Compare strategy to identify which resolver retur

newDNSCache creates a new DNS cache with the specified size and TTL bounds. Size controls the maximum number of hostnames to cache (LRU eviction when

Put returns a connection to the pool for reuse, or closes it if the pool is full. Always call Put() after you're done with a connection, even if an e

ResolveType performs a DNS query for a specific record type. Returns records on success, or an error if the query fails.

WithTimeout sets the per-query timeout. This timeout applies to individual DNS queries, not the overall Lookup() call. For strategies that query mult

getIPs retrieves cached IP addresses for a hostname if they exist and haven't expired. This is the fast path for lookupIPs() and is crucial for perfor

isExpired checks if the IP cache entry has expired based on DNS TTL.

lookup performs DNS resolution using the configured strategy. Always queries for A and AAAA records (IPv4 and IPv6).

setIPs stores already-parsed IP addresses in the cache with TTL-based expiration. The TTL is passed in from the caller who has already figured out the

This is just a convenience bench test to report CGO status in benchmarks. If the Go compiler is invoked with CGO_ENABLED=1, cgoStatus will be "WithCGO

String returns the string representation of the record type

WithConnPoolSize sets the maximum number of pooled connections per resolver. Connection pooling reduces socket creation/destruction overhead. Each DN

WithLogger sets a custom logger for debugging and monitoring. The logger receives structured log events about query attempts, failures, strategy deci