Documentation ¶
Overview ¶
Package dnscache provides a local DNS cache for LookupHost. The cache has a maximum size and a time-to-live (TTL) for each DNS entry.
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Cache ¶ added in v1.83.0
type Cache struct {
// contains filtered or unexported fields
}
Cache represents a cache for DNS items.
func New ¶
New creates a new DNS resolver with a cache of the specified size and TTL. If the resolver parameter is nil, a default resolver will be used. The size parameter determines the maximum number of DNS entries that can be cached (min = 1). If the size is less than or equal to zero, the cache will have a default size of 1. The ttl parameter specifies the time-to-live for each cached DNS entry.
func (*Cache) DialContext ¶ added in v1.83.0
DialContext dials the network and address specified by the parameters. It resolves the host from the address using the LookupHost method of the Resolver. It then attempts to establish a connection to each resolved IP address until a successful connection is made. If all connection attempts fail, it returns an error. The function returns the established net.Conn and any error encountered during the process. This function can replace the DialContext in http.Transport.
func (*Cache) LookupHost ¶ added in v1.83.0
LookupHost performs a DNS lookup for the given host using the DNSCacheResolver. It first checks if the host is already cached and not expired. If so, it returns the cached addresses. Otherwise, it performs a DNS lookup using the underlying Resolver and caches the obtained addresses for future use. Duplicate lookup calls for the same host will wait for the first lookup to complete.