exdns

Documentation

Overview

Package exdns contains helpers to work with dns.Msg

Index

• func AsServerAddress(server string) (string, error)
• func CleanString(v fmt.Stringer) string
• func Decanonize(qName string) string
• func ForEachAnswer[T dns.RR](msg *dns.Msg, fn func(v T))
• func ForEachQuestion(req *dns.Msg, fn func(dns.Question))
• func ForEachQuestionOfClass(req *dns.Msg, qClass uint16, fn func(dns.Question))
• func ForEachRR[T dns.RR](records []dns.RR, fn func(v T))
• func GetFirstAnswer[T dns.RR](msg *dns.Msg) T
• func GetFirstRR[T dns.RR](records []dns.RR) (T, bool)
• func HasAnswerType(msg *dns.Msg, qType uint16) bool
• func HasNsType(msg *dns.Msg, qType uint16) bool
• func NewRequestFromParts(qName string, qClass uint16, qType uint16) *dns.Msg
• func RestoreReturn(req, resp *dns.Msg, err error) (*dns.Msg, error)
• func TrimQ(s []dns.Question, cond func(q dns.Question) bool) []dns.Question
• func TrimRR(s []dns.RR, cond func(rr dns.RR) bool) []dns.RR
• func ValidateResponse(server string, resp *dns.Msg, err error) error
• func ValidateRestoreReturn(req, resp *dns.Msg, server string, err error) (*dns.Msg, error)

Functions

func AsServerAddress

func AsServerAddress(server string) (string, error)

AsServerAddress validates and optionally appends :53 port if it wasn't specified already

func CleanString

func CleanString(v fmt.Stringer) string

CleanString replaces all whitespace on the `.String()` output of a command with single spaces, to turn them into readable fields in logs.

func Decanonize

func Decanonize(qName string) string

Decanonize removes the trailing . if present, unless it's the root dot

func ForEachAnswer

func ForEachAnswer[T dns.RR](msg *dns.Msg, fn func(v T))

ForEachAnswer calls a function for each answer of the specified type.

func ForEachQuestion

func ForEachQuestion(req *dns.Msg, fn func(dns.Question))

ForEachQuestion calls a function for each question on the given request.

func ForEachQuestionOfClass

func ForEachQuestionOfClass(req *dns.Msg, qClass uint16, fn func(dns.Question))

ForEachQuestionOfClass calls a function for each question of the specified class on the given request

func ForEachRR

func ForEachRR[T dns.RR](records []dns.RR, fn func(v T))

ForEachRR calls a function for each dns.RR of the specified type.

func GetFirstAnswer

func GetFirstAnswer[T dns.RR](msg *dns.Msg) T

GetFirstAnswer returns the first answer for a specified type.

func GetFirstRR

func GetFirstRR[T dns.RR](records []dns.RR) (T, bool)

GetFirstRR returns the first RR for a specified type on the given slice.

func HasAnswerType

func HasAnswerType(msg *dns.Msg, qType uint16) bool

HasAnswerType checks if a dns.Msg contains answers of the specified type.

func HasNsType

func HasNsType(msg *dns.Msg, qType uint16) bool

HasNsType checks if a dns.Msg contains Ns entries of the specified type

func NewRequestFromParts

func NewRequestFromParts(qName string, qClass uint16, qType uint16) *dns.Msg

NewRequestFromParts creates a new dns.Msg from the described question.

func RestoreReturn

func RestoreReturn(req, resp *dns.Msg, err error) (*dns.Msg, error)

RestoreReturn makes sure the response carries the same ID as the original request before returning it an already validated response.

func TrimQ

func TrimQ(s []dns.Question, cond func(q dns.Question) bool) []dns.Question

TrimQ removes entries matching the condition from a dns.Question slice

func TrimRR

func TrimRR(s []dns.RR, cond func(rr dns.RR) bool) []dns.RR

TrimRR removes entries matching the condition from a dns.RR slice

func ValidateResponse

func ValidateResponse(server string, resp *dns.Msg, err error) error

ValidateResponse wraps errors.ValidateResponse to avoid getting nil errors typed as *net.DNSError, which aren't nil anymore.

func ValidateRestoreReturn

func ValidateRestoreReturn(req, resp *dns.Msg,
	server string, err error) (*dns.Msg, error)

ValidateRestoreReturn validates a response and makes sure it carries the same ID as the original request