util

Documentation

Index

• Variables
• func ClearFqdnCache()
• func DNS01Record(domain, value string) (string, string, int)
• func FindZoneByFqdn(fqdn string, nameservers []string) (string, error)
• func ToFqdn(name string) string
• func UnFqdn(name string) string
• func WaitFor(timeout, interval time.Duration, f func() (bool, error)) error

Variables

var DNSTimeout = 10 * time.Second

DNSTimeout is used to override the default DNS timeout of 10 seconds.

var (
	// PreCheckDNS checks DNS propagation before notifying ACME that
	// the DNS challenge is ready.
	PreCheckDNS preCheckDNSFunc = checkDNSPropagation
)

var RecursiveNameservers = getNameservers(defaultResolvConf, defaultNameservers)

Functions

func ClearFqdnCache

func ClearFqdnCache()

ClearFqdnCache clears the cache of fqdn to zone mappings. Primarily used in testing.

func DNS01Record

func DNS01Record(domain, value string) (string, string, int)

DNS01Record returns a DNS record which will fulfill the `dns-01` challenge TODO: move this into a non-generic place by resolving import cycle in dns package

func FindZoneByFqdn

func FindZoneByFqdn(fqdn string, nameservers []string) (string, error)

FindZoneByFqdn determines the zone apex for the given fqdn by recursing up the domain labels until the nameserver returns a SOA record in the answer section.

func ToFqdn

func ToFqdn(name string) string

ToFqdn converts the name into a fqdn appending a trailing dot.

func UnFqdn

func UnFqdn(name string) string

UnFqdn converts the fqdn into a name removing the trailing dot.

func WaitFor

func WaitFor(timeout, interval time.Duration, f func() (bool, error)) error

WaitFor polls the given function 'f', once every 'interval', up to 'timeout'.