dns

README

This is a fork of https://pkg.go.dev/tailscale.com@v1.34.2/net/dns with modification to fit ctrld use case.

Documentation

Index

• type HostEntry
• type OSConfig
  • func (a OSConfig) Equal(b OSConfig) bool
  • func (a OSConfig) Format(f fmt.State, verb rune)
  • func (o OSConfig) IsZero() bool
• type OSConfigurator
  • func NewOSConfigurator(logf logger.Logf, interfaceName string) (ret OSConfigurator, err error)

Types

type HostEntry

type HostEntry struct {
	Addr  netip.Addr
	Hosts []string
}

HostEntry represents a single line in the OS's hosts file.

type OSConfig

type OSConfig struct {
	// Hosts is a map of DNS FQDNs to their IPs, which should be added to the
	// OS's hosts file. Currently, (2022-08-12) it is only populated for Windows
	// in SplitDNS mode and with Smart Name Resolution turned on.
	Hosts []*HostEntry
	// Nameservers are the IP addresses of the nameservers to use.
	Nameservers []netip.Addr
	// SearchDomains are the domain suffixes to use when expanding
	// single-label name queries. SearchDomains is additive to
	// whatever non-Tailscale search domains the OS has.
	SearchDomains []dnsname.FQDN
	// MatchDomains are the DNS suffixes for which Nameservers should
	// be used. If empty, Nameservers is installed as the "primary" resolver.
	MatchDomains []dnsname.FQDN
}

OSConfig is an OS DNS configuration.

func (OSConfig) Equal

func (a OSConfig) Equal(b OSConfig) bool

func (OSConfig) Format

func (a OSConfig) Format(f fmt.State, verb rune)

Format implements the fmt.Formatter interface to ensure that Hosts is printed correctly (i.e. not as a bunch of pointers).

Fixes https://github.com/tailscale/tailscale/issues/5669

func (OSConfig) IsZero

func (o OSConfig) IsZero() bool

type OSConfigurator

type OSConfigurator interface {
	// SetDNS updates the OS's DNS configuration to match cfg.
	// If cfg is the zero value, all ctrld-related DNS
	// configuration is removed.
	// SetDNS must not be called after Close.
	// SetDNS takes ownership of cfg.
	SetDNS(cfg OSConfig) error

	// Close removes ctrld-related DNS configuration from the OS.
	Close() error

	Mode() string
}

An OSConfigurator applies DNS settings to the operating system.

func NewOSConfigurator

func NewOSConfigurator(logf logger.Logf, interfaceName string) (ret OSConfigurator, err error)