transport

Documentation

Index

• Constants
• Variables
• type Common
• type DNSCrypt
  • func (d *DNSCrypt) Close() error
  • func (d *DNSCrypt) Exchange(msg *dns.Msg) (*dns.Msg, error)
• type HTTP
  • func (h *HTTP) Close() error
  • func (h *HTTP) Exchange(m *dns.Msg) (*dns.Msg, error)
• type ODoH
  • func (o *ODoH) Close() error
  • func (o *ODoH) Exchange(m *dns.Msg) (*dns.Msg, error)
• type Plain
  • func (p *Plain) Close() error
  • func (p *Plain) Exchange(m *dns.Msg) (*dns.Msg, error)
• type QUIC
  • func (q *QUIC) Close() error
  • func (q *QUIC) Exchange(msg *dns.Msg) (*dns.Msg, error)
• type TLS
  • func (t *TLS) Close() error
  • func (t *TLS) Exchange(msg *dns.Msg) (*dns.Msg, error)
• type Transport
• type Type

Constants

const (
	DoQNoError          = 0x0        // No error. This is used when the connection or stream needs to be closed, but there is no error to signal.
	DoQInternalError    = 0x1        // The DoQ implementation encountered an internal error and is incapable of pursuing the transaction or the connection.
	DoQProtocolError    = 0x2        // The DoQ implementation encountered a protocol error and is forcibly aborting the connection.
	DoQRequestCancelled = 0x3        // A DoQ client uses this to signal that it wants to cancel an outstanding transaction.
	DoQExcessiveLoad    = 0x4        // A DoQ implementation uses this to signal when closing a connection due to excessive load.
	DoQUnspecifiedError = 0x5        // A DoQ implementation uses this in the absence of a more specific error code.
	DoQErrorReserved    = 0xd098ea5e // Alternative error code used for tests.
)

DoQ Error Codes https://datatracker.ietf.org/doc/html/rfc9250#section-8.4

const ODoHContentType = "application/oblivious-dns-message"

Variables

var Types = []Type{TypePlain, TypeTCP, TypeTLS, TypeHTTP, TypeQUIC, TypeDNSCrypt}

Types is a list of all supported transports

Types

type Common

type Common struct {
	Server    string
	ReuseConn bool
}

type DNSCrypt

type DNSCrypt struct {
	Common
	ServerStamp string
	TCP         bool // default false (UDP)
	UDPSize     int

	// ServerStamp takes precedence if set
	PublicKey    string
	ProviderName string
	// contains filtered or unexported fields
}

func (*DNSCrypt) Close

func (d *DNSCrypt) Close() error

func (*DNSCrypt) Exchange

func (d *DNSCrypt) Exchange(msg *dns.Msg) (*dns.Msg, error)

type HTTP

type HTTP struct {
	Common
	TLSConfig    *tls.Config
	UserAgent    string
	Method       string
	HTTP2, HTTP3 bool
	NoPMTUd      bool
	Headers      map[string][]string
	// contains filtered or unexported fields
}

HTTP makes a DNS query over HTTP(s)

func (*HTTP) Close

func (h *HTTP) Close() error

func (*HTTP) Exchange

func (h *HTTP) Exchange(m *dns.Msg) (*dns.Msg, error)

type ODoH

type ODoH struct {
	Common    // Server is the target
	Proxy     string
	TLSConfig *tls.Config
	// contains filtered or unexported fields
}

ODoH makes a DNS query over ODoH

func (*ODoH) Close

func (o *ODoH) Close() error

func (*ODoH) Exchange

func (o *ODoH) Exchange(m *dns.Msg) (*dns.Msg, error)

type Plain

type Plain struct {
	Common
	PreferTCP bool
	EDNS      bool
	UDPBuffer uint16
	Timeout   time.Duration
}

Plain makes a DNS query over TCP or UDP (with TCP fallback)

func (*Plain) Close

func (p *Plain) Close() error

Close is a no-op for the plain transport

func (*Plain) Exchange

func (p *Plain) Exchange(m *dns.Msg) (*dns.Msg, error)

type QUIC

type QUIC struct {
	Common
	TLSConfig       *tls.Config
	PMTUD           bool
	AddLengthPrefix bool
	// contains filtered or unexported fields
}

QUIC makes a DNS query over QUIC

func (*QUIC) Close

func (q *QUIC) Close() error

func (*QUIC) Exchange

func (q *QUIC) Exchange(msg *dns.Msg) (*dns.Msg, error)

type TLS

type TLS struct {
	Common
	TLSConfig *tls.Config
	// contains filtered or unexported fields
}

TLS makes a DNS query over TLS

func (*TLS) Close

func (t *TLS) Close() error

Close closes the TLS connection

func (*TLS) Exchange

func (t *TLS) Exchange(msg *dns.Msg) (*dns.Msg, error)

type Transport

type Transport interface {
	Exchange(*dns.Msg) (*dns.Msg, error)
	Close() error
}

type Type

type Type string

const (
	TypePlain    Type = "plain"
	TypeTCP      Type = "tcp"
	TypeTLS      Type = "tls"
	TypeHTTP     Type = "http"
	TypeQUIC     Type = "quic"
	TypeDNSCrypt Type = "dnscrypt"
)