dnsutils

README

dnsutils

Golang DNS dig

go get github.com/livingopensource/dnsutils

//Normal

package main

import (
	"fmt"
	"github.com/livingopensource/dnsutils"
)

func main() {
    var dig dnsutils.Dig 
    dig.SetDNS("8.8.8.8") //or ns.xxx.com 
    a, err := dig.A("google.com")  // dig google.com @8.8.8.8
    fmt.Println(a, err)
}

//msg

package main

import (
	"fmt"
	"github.com/livingopensource/dnsutils"
	"github.com/miekg/dns"
)

func main() {
	var dig dnsutils.Dig
	dig.SetDNS("1.1.1.1")
	msg, err := dig.GetMsg(dns.TypeA, "google.com")
	if err != nil {
		fmt.Println(err)
		return
	}
	// fmt.Println(msg)
	// or
	fmt.Println(msg.Question) //question section
	fmt.Println(msg.Answer)   //answer section.
	fmt.Println(msg.Ns)       //authority section.
	fmt.Println(msg.Extra)    //additional section.
}

//EDNS0ClientSubnet

package main

import (
	"fmt"
	"github.com/livingopensource/dnsutils"
)

func main() {
    var dig dnsutils.Dig
    dig.SetDNS("8.8.8.8") //or ns.xxx.com
    dig.SetEDNS0ClientSubnet("123.123.123.123")   //support edns0clientsubnet
    a, err := dig.A("google.com")  // dig google.com @8.8.8.8 +client=123.123.123.123
    fmt.Println(a, err)
}

//Retry

package main

import (
	"fmt"
	"github.com/livingopensource/dnsutils"
)

func main() {
    var dig dnsutils.Dig
    dig.Retry=3 //retry  when write or read message return error . defualt 1
    dig.SetDNS("8.8.8.8") //or ns.xxx.com 
    a, err := dig.A("google.com")  // dig google.com @8.8.8.8
    fmt.Println(a, err)
}

//dig +trace

package main

import (
	"fmt"
	"github.com/livingopensource/dnsutils"
)

func main() {
	domain := "google.com"
	var dig dnsutils.Dig
	rsps, err := dig.Trace(domain)  //dig +trace google.com
	if err != nil {
		fmt.Println(err)
		return
	}
	for _, rsp := range rsps {
		if rsp.Msg.Authoritative {
			for _, answer := range rsp.Msg.Answer {
				fmt.Println(answer)
			}
		}
		for _, ns := range rsp.Msg.Ns {
			fmt.Println(ns)
		}
		fmt.Println("\tReceived from", rsp.Server, rsp.ServerIP)
	}
}

// Check if DNS is polluted

package main

import (
	"fmt"
	"github.com/livingopensource/dnsutils"
)

func main() {
	polluted, err := dnsutils.IsPolluted("facebook.com")
	if err != nil {
		fmt.Println(err)
		return
	}
	if polluted {
		fmt.Println("DNS is polluted")
	} else {
		fmt.Println("Ok")
	}
}

//SetBackupDNS
//Initiate requests to two DNS settings at the same time, returning the fastest response result
package main

import (
	"fmt"
	"github.com/livingopensource/dnsutils"
)

func main() {
	var dig dnsutils.Dig
	dig.SetDNS("1.1.1.1")
	dig.SetBackupDNS("8.8.8.8")
	a, err := dig.A("google.com")
	if err != nil {
		fmt.Println(err)
		return
	}
	fmt.Println(a)
}

Documentation

Index

• func IsPolluted(domain string) (bool, error)
• func NewMsg(Type uint16, domain string) *dns.Msg
• type Dig
  • func (d *Dig) A(domain string) ([]*dns.A, error)
  • func (d *Dig) AAAA(domain string) ([]*dns.AAAA, error)
  • func (d *Dig) At(host string) error
  • func (d *Dig) CAA(domain string) ([]*dns.CAA, error)
  • func (d *Dig) CNAME(domain string) ([]*dns.CNAME, error)
  • func (d *Dig) Exchange(m *dns.Msg) (*dns.Msg, error)
  • func (d *Dig) GetMsg(Type uint16, domain string) (*dns.Msg, error)
  • func (d *Dig) MX(domain string) ([]*dns.MX, error)
  • func (d *Dig) NS(domain string) ([]*dns.NS, error)
  • func (d *Dig) PTR(domain string) ([]*dns.PTR, error)
  • func (d *Dig) SOA(domain string) ([]*dns.SOA, error)
  • func (d *Dig) SPF(domain string) ([]*dns.SPF, error)
  • func (d *Dig) SRV(domain string) ([]*dns.SRV, error)
  • func (d *Dig) SetBackupDNS(host string) error
  • func (d *Dig) SetDNS(host string) error
  • func (d *Dig) SetEDNS0ClientSubnet(clientip string) error
  • func (d *Dig) SetTimeOut(t time.Duration)
  • func (d *Dig) TXT(domain string) ([]*dns.TXT, error)
  • func (d *Dig) Trace(domain string) ([]TraceResponse, error)
  • func (d *Dig) TraceForRecord(domain string, msgType uint16) ([]TraceResponse, error)
  • func (d Dig) UseBackup() Dig
• type TraceResponse

Functions

func IsPolluted

func IsPolluted(domain string) (bool, error)

IsPolluted domain

func NewMsg

func NewMsg(Type uint16, domain string) *dns.Msg

NewMsg query msg

Types

type Dig

type Dig struct {
	LocalAddr        string
	RemoteAddr       string
	BackupRemoteAddr string
	EDNSSubnet       net.IP
	DialTimeout      time.Duration
	WriteTimeout     time.Duration
	ReadTimeout      time.Duration
	Protocol         string
	Retry            int
	Fallback         bool //if Truncated == true; udp -> tcp
	// contains filtered or unexported fields
}

Dig dig

func (*Dig) A

func (d *Dig) A(domain string) ([]*dns.A, error)

A dig a

func (*Dig) AAAA

func (d *Dig) AAAA(domain string) ([]*dns.AAAA, error)

AAAA dig aaaa

func (*Dig) At

func (d *Dig) At(host string) error

At dns server,SetDNS,

func (*Dig) CAA

func (d *Dig) CAA(domain string) ([]*dns.CAA, error)

CAA dig caa

func (*Dig) CNAME

func (d *Dig) CNAME(domain string) ([]*dns.CNAME, error)

CNAME dig cname

func (*Dig) Exchange

func (d *Dig) Exchange(m *dns.Msg) (*dns.Msg, error)

Exchange msg

func (*Dig) GetMsg

func (d *Dig) GetMsg(Type uint16, domain string) (*dns.Msg, error)

GetMsg msg

func (*Dig) MX

func (d *Dig) MX(domain string) ([]*dns.MX, error)

MX dig mx

func (*Dig) NS

func (d *Dig) NS(domain string) ([]*dns.NS, error)

NS dig ns

func (*Dig) PTR

func (d *Dig) PTR(domain string) ([]*dns.PTR, error)

PTR dig ptr

func (*Dig) SOA

func (d *Dig) SOA(domain string) ([]*dns.SOA, error)

SOA dig soa

func (*Dig) SPF

func (d *Dig) SPF(domain string) ([]*dns.SPF, error)

SPF dig spf

func (*Dig) SRV

func (d *Dig) SRV(domain string) ([]*dns.SRV, error)

SRV dig srv

func (*Dig) SetBackupDNS

func (d *Dig) SetBackupDNS(host string) error

SetBackupDNS server msg

func (*Dig) SetDNS

func (d *Dig) SetDNS(host string) error

SetDNS dns server Deprecated: use At

func (*Dig) SetEDNS0ClientSubnet

func (d *Dig) SetEDNS0ClientSubnet(clientip string) error

SetEDNS0ClientSubnet +client

func (*Dig) SetTimeOut

func (d *Dig) SetTimeOut(t time.Duration)

SetTimeOut set read write dial timeout

func (*Dig) TXT

func (d *Dig) TXT(domain string) ([]*dns.TXT, error)

TXT dig txt

func (*Dig) Trace

func (d *Dig) Trace(domain string) ([]TraceResponse, error)

Trace dig +trace

func (*Dig) TraceForRecord

func (d *Dig) TraceForRecord(domain string, msgType uint16) ([]TraceResponse, error)

Trace dig +trace -t msqType

func (Dig) UseBackup

func (d Dig) UseBackup() Dig

type TraceResponse

type TraceResponse struct {
	Server   string
	ServerIP string
	Msg      *dns.Msg
}

TraceResponse dig +trace