doh

Documentation

Index

• Variables
• func NewHttpClientWithTimeout(timeout time.Duration) *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 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 NewHttpClientWithTimeout

func NewHttpClientWithTimeout(timeout time.Duration) *http.Client

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 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
}