dnsring

README

dnsring

Ring of DNS servers for spreading IP lookups over multiple DNS servers. Uses an in-memory cache to avoid repeated lookups. Only returns the first IP if matches and prefers IPv4 over IPv6.

Usage Example

    DNSRing := dnsring.New(dns.NewServer("8.8.8.8", 53, 2000), dns.NewServer("8.8.4.4", 53, 2000))
    host := "google.com"
	ip := DNSRing.Next().HostToIP(host)
	if ip == "" {
        fmt.Printf("%s did not resolve to an IP\n", host)
	} else {
        fmt.Printf("%s has the IP: %s\n", host, ip)
    }

Documentation

Index

• func AddCacheExclusions(exclusions map[string]string)
• type Cache
• type Resolver
  • func NewResolver(host string, port uint, timeout time.Duration) *Resolver
  • func (dr *Resolver) HostToIP(host string) string
• type Ring
  • func New(servers ...Server) *Ring
  • func (rs *Ring) Next() *Resolver
• type Server
  • func NewServer(host string, port, timeout int) *Server

Functions

func AddCacheExclusions

func AddCacheExclusions(exclusions map[string]string)

Types

type Cache

type Cache struct {
	// contains filtered or unexported fields
}

type Resolver

type Resolver struct {
	Host     string        `yaml:"host"`
	Port     uint          `yaml:"port"`
	Resolver *net.Resolver `yaml:"-"`
}

func NewResolver

func NewResolver(host string, port uint, timeout time.Duration) *Resolver

func (*Resolver) HostToIP

func (dr *Resolver) HostToIP(host string) string

type Ring

type Ring struct {
	// contains filtered or unexported fields
}

func New

func New(servers ...Server) *Ring

func (*Ring) Next

func (rs *Ring) Next() *Resolver

type Server

type Server struct {
	Host    string `yaml:"host"`
	Port    int    `yaml:"port"`
	Timeout int    `yaml:"timeout"`
}

func NewServer

func NewServer(host string, port, timeout int) *Server