dnsutil

Documentation

Index

• Constants
• Variables
• func CheckAndSetEdns(req, resp *dns.Msg) error
• func EqualNames(a, b string) bool
• func FixNames(rrs []dns.RR, question *dns.Question)
• func GetAddrProtocol(addr net.Addr, cstate *tls.ConnectionState) string
• func GetWriterProtocol(w dns.ResponseWriter) string
• func LowerName(s string) string
• func MaybeTruncate(req, resp *dns.Msg, net string)
• func MsgAcceptFunc(dh dns.Header) dns.MsgAcceptAction
• type DnssecProvider
  • func GenerateDnssecProvider(name string, algo uint8, rrTtl, validFrom, validTo uint32) (*DnssecProvider, error)
  • func (p *DnssecProvider) DS() (*dns.DS, error)
  • func (p *DnssecProvider) PrivKeyBytes() ([]byte, error)
  • func (p *DnssecProvider) Prove(req, resp *dns.Msg, validFrom, validTo uint32) error
  • func (p *DnssecProvider) ProvideKeys(req, resp *dns.Msg) bool
  • func (p *DnssecProvider) SetPrivKeyBytes(b []byte) error
  • func (p *DnssecProvider) Sign(rrs []dns.RR, validFrom, validTo uint32) (sigs []dns.RR, err error)
• type IPCollection
  • func (c *IPCollection) Add(ip net.IP)
• type LoggingHandler
  • func (h *LoggingHandler) RequestCount() uint64
  • func (h *LoggingHandler) ServeDNS(w dns.ResponseWriter, req *dns.Msg)
• type LoggingResponseWriter
  • func (w *LoggingResponseWriter) ConnectionState() *tls.ConnectionState
  • func (w *LoggingResponseWriter) WriteMsg(m *dns.Msg) error
• type RecordGenerator
• type SimpleHandler
  • func (h *SimpleHandler) Init(privKeyBytes []byte) *SimpleHandler
  • func (h *SimpleHandler) SOA(q *dns.Question) dns.RR
  • func (h *SimpleHandler) ServeDNS(w dns.ResponseWriter, req *dns.Msg)
• type StaticRecords
  • func (s StaticRecords) Get(question *dns.Question) (rrs []dns.RR)
  • func (s StaticRecords) MarshalJSON() ([]byte, error)
  • func (p *StaticRecords) UnmarshalJSON(data []byte) error
• type UpdateHandler

Constants

const MaxUdpMsgSize = 1232

Variables

var DefaultNsecTypes = []uint16{
	dns.TypeA,
	dns.TypeNS,
	dns.TypeSOA,
	dns.TypeMX,
	dns.TypeTXT,
	dns.TypeAAAA,
	dns.TypeRRSIG,
	dns.TypeNSEC,
	dns.TypeDNSKEY,
}

Functions

func CheckAndSetEdns

func CheckAndSetEdns(req, resp *dns.Msg) error

checks for edns0 in req, sets edns0 in resp

func EqualNames

func EqualNames(a, b string) bool

fast, ascii-only, case-insensitive equality check

func FixNames

func FixNames(rrs []dns.RR, question *dns.Question)

make names of rrs match case of name in question

func GetAddrProtocol

func GetAddrProtocol(addr net.Addr, cstate *tls.ConnectionState) string

func GetWriterProtocol

func GetWriterProtocol(w dns.ResponseWriter) string

func LowerName

func LowerName(s string) string

fast, ascii-only string case lower-er

func MaybeTruncate

func MaybeTruncate(req, resp *dns.Msg, net string)

determines max size, edns0 aware, truncates if necessary

func MsgAcceptFunc

func MsgAcceptFunc(dh dns.Header) dns.MsgAcceptAction

Types

type DnssecProvider

type DnssecProvider struct {
	Ksk        *dns.DNSKEY
	Zsk        *dns.DNSKEY
	ZskPrivKey crypto.Signer
	KeySig     *dns.RRSIG
	NsecTypes  []uint16
}

func GenerateDnssecProvider

func GenerateDnssecProvider(name string, algo uint8, rrTtl, validFrom, validTo uint32) (*DnssecProvider, error)

func (*DnssecProvider) DS

func (p *DnssecProvider) DS() (*dns.DS, error)

func (*DnssecProvider) PrivKeyBytes

func (p *DnssecProvider) PrivKeyBytes() ([]byte, error)

func (*DnssecProvider) Prove

func (p *DnssecProvider) Prove(req, resp *dns.Msg, validFrom, validTo uint32) error

adds DNSSEC signatures to resp

func (*DnssecProvider) ProvideKeys

func (p *DnssecProvider) ProvideKeys(req, resp *dns.Msg) bool

adds DNSSEC keys (and keysig) to resp if requested by req, returns true iff keys were added

func (*DnssecProvider) SetPrivKeyBytes

func (p *DnssecProvider) SetPrivKeyBytes(b []byte) error

func (*DnssecProvider) Sign

func (p *DnssecProvider) Sign(rrs []dns.RR, validFrom, validTo uint32) (sigs []dns.RR, err error)

type IPCollection

type IPCollection struct {
	IPv4 []net.IP
	IPv6 []net.IP
}

func (*IPCollection) Add

func (c *IPCollection) Add(ip net.IP)

type LoggingHandler

type LoggingHandler struct {
	Logger *log.Logger

	dns.Handler
	// contains filtered or unexported fields
}

func (*LoggingHandler) RequestCount

func (h *LoggingHandler) RequestCount() uint64

func (*LoggingHandler) ServeDNS

func (h *LoggingHandler) ServeDNS(w dns.ResponseWriter, req *dns.Msg)

type LoggingResponseWriter

type LoggingResponseWriter struct {
	dns.ResponseWriter
	Rcode   int
	AnCount int
	NsCount int
	ExCount int
	Written bool
}

func (*LoggingResponseWriter) ConnectionState

func (w *LoggingResponseWriter) ConnectionState() *tls.ConnectionState

func (*LoggingResponseWriter) WriteMsg

func (w *LoggingResponseWriter) WriteMsg(m *dns.Msg) error

type RecordGenerator

type RecordGenerator interface {
	GenerateRecords(question *dns.Question, zone string) (rrs []dns.RR, validName bool)
}

type SimpleHandler

type SimpleHandler struct {
	Zone           string
	Ns             []string
	HostMasterMbox string
	StaticRecords  StaticRecords
	RecordGenerator
	UpdateHandler
	*DnssecProvider
}

func (*SimpleHandler) Init

func (h *SimpleHandler) Init(privKeyBytes []byte) *SimpleHandler

func (*SimpleHandler) SOA

func (h *SimpleHandler) SOA(q *dns.Question) dns.RR

func (*SimpleHandler) ServeDNS

func (h *SimpleHandler) ServeDNS(w dns.ResponseWriter, req *dns.Msg)

type StaticRecords

type StaticRecords []dns.RR

func (StaticRecords) Get

func (s StaticRecords) Get(question *dns.Question) (rrs []dns.RR)

func (StaticRecords) MarshalJSON

func (s StaticRecords) MarshalJSON() ([]byte, error)

func (*StaticRecords) UnmarshalJSON

func (p *StaticRecords) UnmarshalJSON(data []byte) error

type UpdateHandler

type UpdateHandler interface {
	HandleUpdate(w dns.ResponseWriter, req *dns.Msg, zone string)
}