doh

Documentation

Index

• Variables
• func NewHttpClient(opts ...ClientOption) *http.Client
• type Answer
• type Client
  • func New() *Client
  • func NewWithOptions(options Options) *Client
  • func (c *Client) Query(name string, question QuestionType) (*Response, error)
  • func (c *Client) QueryWithDOH(method Method, r Resolver, name string, question uint16) (*dns.Msg, error)
  • func (c *Client) QueryWithDOHMsg(method Method, r Resolver, msg *dns.Msg) (*dns.Msg, error)
  • func (c *Client) QueryWithJsonAPI(r Resolver, name string, question QuestionType) (*Response, error)
  • func (c *Client) QueryWithResolver(r Resolver, name string, question QuestionType) (*Response, error)
• type ClientOption
  • func WithInsecureSkipVerify() ClientOption
  • func WithProxy(proxyURL string) ClientOption
  • func WithTimeout(timeout time.Duration) ClientOption
• type Method
• type Options
• type Question
• type QuestionType
  • func (q QuestionType) ToString() string
• type Resolver
• type Response

Variables

var (
	Cloudflare = Resolver{Name: "Cloudflare", URL: "https://cloudflare-dns.com/dns-query"}
	Google     = Resolver{Name: "Google", URL: "https://dns.google.com/resolve"}
	Quad9      = Resolver{Name: "Cloudflare", URL: "https://dns.quad9.net:5053/dns-query"}
	PowerDNS   = Resolver{Name: "PowerDNS", URL: "https://doh.powerdns.org/dns-query"}
	OpenDNS    = Resolver{Name: "OpenDNS", URL: "https://doh.opendns.com/dns-query"}
)

var DefaultTimeout = 5 * time.Second

Functions

func NewHttpClient

func NewHttpClient(opts ...ClientOption) *http.Client

NewHttpClient creates a new http.Client with the given options

Types

type Answer

type Answer struct {
	Name string `json:"name"`
	Type int    `json:"type"`
	TTL  int    `json:"TTL"`
	Data string `json:"data"`
}

type Client

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

func New

func New() *Client

func NewWithOptions

func NewWithOptions(options Options) *Client

func (*Client) Query

func (c *Client) Query(name string, question QuestionType) (*Response, error)

func (*Client) QueryWithDOH

func (c *Client) QueryWithDOH(method Method, r Resolver, name string, question uint16) (*dns.Msg, error)

func (*Client) QueryWithDOHMsg

func (c *Client) QueryWithDOHMsg(method Method, r Resolver, msg *dns.Msg) (*dns.Msg, error)

func (*Client) QueryWithJsonAPI

func (c *Client) QueryWithJsonAPI(r Resolver, name string, question QuestionType) (*Response, error)

func (*Client) QueryWithResolver

func (c *Client) QueryWithResolver(r Resolver, name string, question QuestionType) (*Response, error)

type ClientOption

type ClientOption func(*http.Client)

ClientOption defines a function type for configuring an http.Client

func WithInsecureSkipVerify

func WithInsecureSkipVerify() ClientOption

WithInsecureSkipVerify sets the InsecureSkipVerify option for the TLS config

func WithProxy

func WithProxy(proxyURL string) ClientOption

WithProxy sets a proxy for the http.Client

func WithTimeout

func WithTimeout(timeout time.Duration) ClientOption

WithTimeout sets the timeout for the http.Client

type Method

type Method string

const (
	MethodGet  Method = http.MethodGet
	MethodPost Method = http.MethodPost
)

type Options

type Options struct {
	DefaultResolver Resolver
	HttpClient      *http.Client
}

type Question

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

type QuestionType

type QuestionType string

const (
	A     QuestionType = "A"
	AAAA  QuestionType = "AAAA"
	MX    QuestionType = "MX"
	NS    QuestionType = "NS"
	SOA   QuestionType = "SOA"
	PTR   QuestionType = "PTR"
	ANY   QuestionType = "ANY"
	CNAME QuestionType = "CNAME"
)

func (QuestionType) ToString

func (q QuestionType) ToString() string

type Resolver

type Resolver struct {
	Name string
	URL  string
}

type Response

type Response struct {
	Status   int        `json:"Status"`
	TC       bool       `json:"TC"`
	RD       bool       `json:"RD"`
	RA       bool       `json:"RA"`
	AD       bool       `json:"AD"`
	CD       bool       `json:"CD"`
	Question []Question `json:"Question"`
	Answer   []Answer   `json:"Answer"`
	Comment  string
}