resolvers

Documentation

Index

• type Answer
• type Authority
• type ClassicResolver
  • func (r *ClassicResolver) Lookup(question dns.Question) (Response, error)
• type ClassicResolverOpts
• type DNSCryptResolver
  • func (r *DNSCryptResolver) Lookup(question dns.Question) (Response, error)
• type DNSCryptResolverOpts
• type DOHResolver
  • func (r *DOHResolver) Lookup(question dns.Question) (Response, error)
• type DOQResolver
  • func (r *DOQResolver) Lookup(question dns.Question) (Response, error)
• type Options
• type Question
• type Resolver
  • func LoadResolvers(opts Options) ([]Resolver, error)
  • func NewClassicResolver(server string, classicOpts ClassicResolverOpts, resolverOpts Options) (Resolver, error)
  • func NewDNSCryptResolver(server string, dnscryptOpts DNSCryptResolverOpts, resolverOpts Options) (Resolver, error)
  • func NewDOHResolver(server string, resolverOpts Options) (Resolver, error)
  • func NewDOQResolver(server string, resolverOpts Options) (Resolver, error)
• type Response

Types

type Answer

type Answer struct {
	Name       string `json:"name"`
	Type       string `json:"type"`
	Class      string `json:"class"`
	TTL        string `json:"ttl"`
	Address    string `json:"address"`
	Status     string `json:"status"`
	RTT        string `json:"rtt"`
	Nameserver string `json:"nameserver"`
}

type Authority

type Authority struct {
	Name       string `json:"name"`
	Type       string `json:"type"`
	Class      string `json:"class"`
	TTL        string `json:"ttl"`
	MName      string `json:"mname"`
	Status     string `json:"status"`
	RTT        string `json:"rtt"`
	Nameserver string `json:"nameserver"`
}

type ClassicResolver

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

ClassicResolver represents the config options for setting up a Resolver.

func (*ClassicResolver) Lookup

func (r *ClassicResolver) Lookup(question dns.Question) (Response, error)

Lookup takes a dns.Question and sends them to DNS Server. It parses the Response from the server in a custom output format.

type ClassicResolverOpts

type ClassicResolverOpts struct {
	IPv4Only bool
	IPv6Only bool
	UseTLS   bool
	UseTCP   bool
}

ClassicResolverOpts holds options for setting up a Classic resolver.

type DNSCryptResolver

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

DNSCryptResolver represents the config options for setting up a Resolver.

func (*DNSCryptResolver) Lookup

func (r *DNSCryptResolver) Lookup(question dns.Question) (Response, error)

Lookup takes a dns.Question and sends them to DNS Server. It parses the Response from the server in a custom output format.

type DNSCryptResolverOpts

type DNSCryptResolverOpts struct {
	IPv4Only bool
	IPv6Only bool
	UseTLS   bool
	UseTCP   bool
}

DNSCryptResolverOpts holds options for setting up a DNSCrypt resolver.

type DOHResolver

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

DOHResolver represents the config options for setting up a DOH based resolver.

func (*DOHResolver) Lookup

func (r *DOHResolver) Lookup(question dns.Question) (Response, error)

Lookup takes a dns.Question and sends them to DNS Server. It parses the Response from the server in a custom output format.

type DOQResolver

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

DOQResolver represents the config options for setting up a DOQ based resolver.

func (*DOQResolver) Lookup

func (r *DOQResolver) Lookup(question dns.Question) (Response, error)

Lookup takes a dns.Question and sends them to DNS Server. It parses the Response from the server in a custom output format.

type Options

type Options struct {
	Nameservers []models.Nameserver
	UseIPv4     bool
	UseIPv6     bool
	SearchList  []string
	Ndots       int
	Timeout     time.Duration
	Logger      *logrus.Logger
}

Options represent a set of common options to configure a Resolver.

type Question

type Question struct {
	Name  string `json:"name"`
	Type  string `json:"type"`
	Class string `json:"class"`
}

type Resolver

type Resolver interface {
	Lookup(dns.Question) (Response, error)
}

Resolver implements the configuration for a DNS Client. Different types of providers can load a DNS Resolver satisfying this interface.

func LoadResolvers

func LoadResolvers(opts Options) ([]Resolver, error)

LoadResolvers loads differently configured resolvers based on a list of nameserver.

func NewClassicResolver

func NewClassicResolver(server string, classicOpts ClassicResolverOpts, resolverOpts Options) (Resolver, error)

NewClassicResolver accepts a list of nameservers and configures a DNS resolver.

func NewDNSCryptResolver

func NewDNSCryptResolver(server string, dnscryptOpts DNSCryptResolverOpts, resolverOpts Options) (Resolver, error)

NewDNSCryptResolver accepts a list of nameservers and configures a DNS resolver.

func NewDOHResolver

func NewDOHResolver(server string, resolverOpts Options) (Resolver, error)

NewDOHResolver accepts a nameserver address and configures a DOH based resolver.

func NewDOQResolver

func NewDOQResolver(server string, resolverOpts Options) (Resolver, error)

NewDOQResolver accepts a nameserver address and configures a DOQ based resolver.

type Response

type Response struct {
	Answers     []Answer    `json:"answers"`
	Authorities []Authority `json:"authorities"`
	Questions   []Question  `json:"questions"`
}

Response represents a custom output format for DNS queries. It wraps metadata about the DNS query and the DNS Answer as well.