dns

package

v0.0.0-...-0cd5192 Latest Latest Go to latest Published: Nov 20, 2021 License: MIT Imports: 13 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

This section is empty.

View Source

var (
	ErrRecordAlreadyExists = errors.New("dns record already exists")
	ErrRecordNotFound      = errors.New("dns record not found")
)

func MessageFromRecord(zone string, rec libdns.Record) (dns.RR, error)

MessageFromRecord parses a libdns.Record and returns a dns.Msg value, using the `zone` argument.

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

Server is used for capturing DNS requests, and storing/serving TXT records for the ACME DNS-01 challenge. It implements certmagic.ACMEDNSProvider.

func NewServer(opts ...ServerOption) *Server

func (srv *Server) AppendRecords(ctx context.Context, zone string, newRecs []libdns.Record) ([]libdns.Record, error)

func (srv *Server) DeleteRecords(ctx context.Context, zone string, deleteRecs []libdns.Record) ([]libdns.Record, error)

func (srv *Server) GetRecords(ctx context.Context, zone string) ([]libdns.Record, error)

func (srv *Server) Run(ctx context.Context) error

Run starts the DNS server.

func (srv *Server) ServeDNS(w dns.ResponseWriter, r *dns.Msg)

func (srv *Server) Shutdown(ctx context.Context) error

type ServerOption func(*Server)

func WithAddress(addr string) ServerOption

func WithLogger(logger *zap.Logger) ServerOption

WithLogger provides a logger, which is used for HTTP related logs.

func WithSOAHostname(soaHostname string) ServerOption

func WithStorage(s certmagic.Storage) ServerOption