spflib

Documentation

Index

• type CachingResolver
  • func NewCache(filename string) (CachingResolver, error)
• type LiveResolver
  • func (l LiveResolver) GetSPF(name string) (string, error)
• type Resolver
• type SPFPart
• type SPFRecord
  • func Parse(text string, dnsres Resolver) (*SPFRecord, error)
  • func (s *SPFRecord) Flatten(spec string) *SPFRecord
  • func (s *SPFRecord) Lookups() int
  • func (rec *SPFRecord) Print() string
  • func (s *SPFRecord) TXT() string
  • func (s *SPFRecord) TXTSplit(pattern string) map[string]string

Types

type CachingResolver

type CachingResolver interface {
	Resolver
	ChangedRecords() []string
	ResolveErrors() []error
	Save(filename string) error
}

CachingResolver wraps a live resolver and adds caching to it. GetSPF will always return the cached value, if present. It will also query the inner resolver and compare results. If a given lookup has inconsistencies between cache and live, GetSPF will return the cached result. All records queries will be stored for the lifetime of the resolver, and can be flushed to disk at the end. All resolution errors from the inner resolver will be saved and can be retreived later.

func NewCache

func NewCache(filename string) (CachingResolver, error)

type LiveResolver

type LiveResolver struct{}

LiveResolver simply queries DNS to resolve SPF records.

func (LiveResolver) GetSPF

func (l LiveResolver) GetSPF(name string) (string, error)

type Resolver

type Resolver interface {
	GetSPF(string) (string, error)
}

Resolver looks up spf txt records associated with a FQDN.

type SPFPart

type SPFPart struct {
	Text          string
	IsLookup      bool
	IncludeRecord *SPFRecord
	IncludeDomain string
}

type SPFRecord

type SPFRecord struct {
	Parts []*SPFPart
}

func Parse

func Parse(text string, dnsres Resolver) (*SPFRecord, error)

func (*SPFRecord) Flatten

func (s *SPFRecord) Flatten(spec string) *SPFRecord

func (*SPFRecord) Lookups

func (s *SPFRecord) Lookups() int

func (*SPFRecord) Print

func (rec *SPFRecord) Print() string

func (*SPFRecord) TXT

func (s *SPFRecord) TXT() string

func (*SPFRecord) TXTSplit

func (s *SPFRecord) TXTSplit(pattern string) map[string]string

TXTSplit returns a set of txt records to use for SPF. pattern given is used to name all chained spf records. patern should include %d, which will be replaced by a counter. should result in fqdn after replacement returned map will have keys with fqdn of resulting records. root record will be under key "@"