dnsvalidator

package module

v0.0.0-...-6d33041 Latest Latest Go to latest Published: Jul 13, 2019 License: MIT Imports: 7 Imported by: 0

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

github.com/pior/dnsvalidator

Links

Open Source Insights

README ¶

DNS Validator

Validate that a set of resource records are set on all nameservers.

Uses github.com/domainr/dnsr as recursor to avoid external DNS caching.

Usage:

import "github.com/pior/dnsvalidator"

dnsv := dnsvalidator.New()
ctx := context.Background()

report, err := dnsv.Inspect(ctx, name, type)

expected := []RR{{Name:  "...", Type:  "CNAME", Value: "..."},}
err = report.Validate(expected)

See example: cmd/test

License

The MIT License (MIT)

Documentation ¶

Index ¶

type ErrInvalid
- func (e *ErrInvalid) Error() string
type NS
type NSReport
type RR
- func (rr *RR) String() string
type Report
- func (r *Report) Validate(expected []RR) error
type Validator
- func New() *Validator

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

This section is empty.

Types ¶

type ErrInvalid ¶

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

func (*ErrInvalid) Error ¶

func (e *ErrInvalid) Error() string

type NS ¶

type NS struct {
	Name string
	IP   string
}

type NSReport ¶

type NSReport struct {
	Rcode int
	RRs   []RR
}

type RR ¶

type RR struct {
	Name  string
	Type  string
	Value string
	TTL   int
}

RR represents a DNS resource record.

func (*RR) String ¶

func (rr *RR) String() string

String returns a string representation of an RR in zone-file format.

type Report ¶

type Report map[NS]NSReport

func (*Report) Validate ¶

func (r *Report) Validate(expected []RR) error

type Validator ¶

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

func New ¶

func New() *Validator

func (*Validator) FindNameservers ¶

func (v *Validator) FindNameservers(ctx context.Context, qname string) (nss []string, err error)

FindNameservers tries to find the nameservers for a given query name, by iterating on parents. Returns the root nameservers if the domain does not exist.

func (*Validator) Inspect ¶

func (v *Validator) Inspect(ctx context.Context, qname string, qtype string) (Report, error)

Inspect queries all nameservers for a query name and type and return a report by nameserver.

func (*Validator) QueryNameserver ¶

func (v *Validator) QueryNameserver(ctx context.Context, qname, qtype, nameserver string) (Report, error)

func (*Validator) QueryNameservers ¶

func (v *Validator) QueryNameservers(ctx context.Context, qname, qtype string, nameservers []string) (Report, error)

Source Files ¶

View all Source files

Directories ¶

Path	Synopsis
cmd
test

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL