resolver

type DNS64ResolverConfig struct {
	// Prefix is the IPv6 prefix to use.
	// If not set, the well-known prefix "64:ff9b::/96" is used.
	Prefix *netip.Prefix
	// DialContext is used to establish a connection to a DNS server.
	DialContext DialContextFunc
}

type DNSResolverConfig struct {
	// Server is the DNS server to query.
	Server netip.AddrPort
	// Transport is the optional transport protocol used for DNS resolution.
	// By default, plain DNS over UDP is used.
	Transport *DNSTransport
	// Timeout is the maximum duration to wait for a query to complete.
	Timeout *time.Duration
	// DialContext is used to establish a connection to a DNS server.
	DialContext DialContextFunc
	// TLSConfig is the configuration for the TLS client used for DNS over TLS.
	TLSConfig *tls.Config
	// SingleRequest is used to query A and AAAA records sequentially.
	// This is mostly useful for avoiding conntrack race issues with DNS over UDP.
	// If you feel the need to enable this, you should probably just use
	// DNS over TCP instead.
	SingleRequest *bool
}

type DNSTransport string

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

type HostsResolver struct {
	// contains filtered or unexported fields
}

type HostsResolverConfig struct {
	// HostsFileReader is an optional reader that will be used as the source of the hosts file.
	// If not provided, the OS's default hosts file will be used.
	HostsFileReader io.Reader
	// DialContext is an optional dialer used for ordering the returned addresses.
	DialContext DialContextFunc
	// NoHostsFile disables the use of the hosts file.
	// This is useful when operating with only ephemeral hosts.
	NoHostsFile *bool
}

type RelativeResolverConfig struct {
	// Search is a list of rooted suffixes to append to the relative name.
	Search []string
	// NDots is the number of dots in a name to trigger an absolute lookup.
	NDots *int
}

type Resolver interface {
	// LookupNetIP looks up host using the resolver. It returns a slice of that
	// host's IP addresses of the type specified by network. The network must be
	// one of "ip", "ip4" or "ip6".
	LookupNetIP(ctx context.Context, network, host string) ([]netip.Addr, error)
}

type RetryResolverConfig struct {
	// Attempts is the number of attempts to make before giving up.
	// Setting this to 0 will cause the resolver to retry indefinitely.
	Attempts *int
}

type SystemResolverConfig struct {
	// HostsFilePath is the optional path to the hosts file.
	// By default, the system's hosts file is used.
	HostsFilePath string
	// DialContext is used to establish a connection to a DNS server.
	DialContext DialContextFunc
}