resolvconf

Documentation

Index

• func Build(path string, dns, dnsSearch []string) error
• func FilterResolvDns(resolvConf []byte, ipv6Enabled bool) ([]byte, bool)
• func Get() ([]byte, error)
• func GetIfChanged() ([]byte, string, error)
• func GetLastModified() ([]byte, string)
• func GetNameservers(resolvConf []byte) []string
• func GetNameserversAsCIDR(resolvConf []byte) []string
• func GetSearchDomains(resolvConf []byte) []string
• func IsLocalhost(ip string) bool

Functions

func Build

func Build(path string, dns, dnsSearch []string) error

func FilterResolvDns

func FilterResolvDns(resolvConf []byte, ipv6Enabled bool) ([]byte, bool)

FilterResolvDns has two main jobs:

1. It looks for localhost (127.*|::1) entries in the provided resolv.conf, removing local nameserver entries, and, if the resulting cleaned config has no defined nameservers left, adds default DNS entries
2. Given the caller provides the enable/disable state of IPv6, the filter code will remove all IPv6 nameservers if it is not enabled for containers

It also returns a boolean to notify the caller if changes were made at all

func Get

func Get() ([]byte, error)

func GetIfChanged

func GetIfChanged() ([]byte, string, error)

Retrieves the host /etc/resolv.conf file, checks against the last hash and, if modified since last check, returns the bytes and new hash. This feature is used by the resolv.conf updater for containers

func GetLastModified

func GetLastModified() ([]byte, string)

retrieve the last used contents and hash of the host resolv.conf Used by containers updating on restart

func GetNameservers

func GetNameservers(resolvConf []byte) []string

GetNameservers returns nameservers (if any) listed in /etc/resolv.conf

func GetNameserversAsCIDR

func GetNameserversAsCIDR(resolvConf []byte) []string

GetNameserversAsCIDR returns nameservers (if any) listed in /etc/resolv.conf as CIDR blocks (e.g., "1.2.3.4/32") This function's output is intended for net.ParseCIDR

func GetSearchDomains

func GetSearchDomains(resolvConf []byte) []string

GetSearchDomains returns search domains (if any) listed in /etc/resolv.conf If more than one search line is encountered, only the contents of the last one is returned.

func IsLocalhost

func IsLocalhost(ip string) bool

returns true if the IP string matches the localhost IP regular expression. Used for determining if nameserver settings are being passed which are localhost addresses