dns

Documentation

Index

• Variables
• type Resolver
  • func NewResolver(name string, serverAddrPort netip.AddrPort, tcpClient zerocopy.TCPClient, ...) *Resolver
  • func (r *Resolver) Lookup(name string) (Result, error)
• type ResolverConfig
  • func (rc *ResolverConfig) Resolver(tcpClientMap map[string]zerocopy.TCPClient, ...) (*Resolver, error)
• type Result

Variables

var ErrLookup = errors.New("name lookup failed")

Types

type Resolver

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

func NewResolver

func NewResolver(name string, serverAddrPort netip.AddrPort, tcpClient zerocopy.TCPClient, udpClient zerocopy.UDPClient, logger *zap.Logger) *Resolver

func (*Resolver) Lookup

func (r *Resolver) Lookup(name string) (Result, error)

type ResolverConfig

type ResolverConfig struct {
	// Name is the resolver's name.
	// The name must be unique among all resolvers.
	Name string `json:"name"`

	// AddrPort is the upstream server's address and port.
	AddrPort netip.AddrPort `json:"addrPort"`

	// TCPClientName is the name of the TCPClient to use.
	// Leave empty to disable TCP.
	TCPClientName string `json:"tcpClientName"`

	// UDPClientName is the name of the UDPClient to use.
	// Leave empty to disable UDP.
	UDPClientName string `json:"udpClientName"`
}

ResolverConfig configures a DNS resolver.

func (*ResolverConfig) Resolver

func (rc *ResolverConfig) Resolver(tcpClientMap map[string]zerocopy.TCPClient, udpClientMap map[string]zerocopy.UDPClient, logger *zap.Logger) (*Resolver, error)

type Result

type Result struct {
	IPv4 []netip.Addr
	IPv6 []netip.Addr

	// TTL is the minimum TTL of A and AAAA RRs.
	TTL time.Time
}

Result represents the result of name resolution.