resolvconf

package

v0.0.0-...-8d193d8 Latest Latest Go to latest Published: Sep 28, 2022 License: Apache-2.0 Imports: 9 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/2018112767/moby

Documentation ¶

Rendered for

Overview ¶

Package resolvconf provides utility code to query and update DNS configuration in /etc/resolv.conf

Index ¶

Constants
func GetNameservers(resolvConf []byte, kind int) []string
func GetNameserversAsCIDR(resolvConf []byte) []string
func GetOptions(resolvConf []byte) []string
func GetSearchDomains(resolvConf []byte) []string
func Path() string
type File

Constants ¶

View Source

const (
	IP = iota // IPv4 and IPv6
	IPv4
	IPv6
)

constants for the IP address type

Variables ¶

This section is empty.

Functions ¶

func GetNameservers ¶

func GetNameservers(resolvConf []byte, kind int) []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 GetOptions ¶

func GetOptions(resolvConf []byte) []string

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

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 Path ¶

func Path() string

Path returns the path to the resolv.conf file that libnetwork should use.

When /etc/resolv.conf contains 127.0.0.53 as the only nameserver, then it is assumed systemd-resolved manages DNS. Because inside the container 127.0.0.53 is not a valid DNS server, Path() returns /run/systemd/resolve/resolv.conf which is the resolv.conf that systemd-resolved generates and manages. Otherwise Path() returns /etc/resolv.conf.

Errors are silenced as they will inevitably resurface at future open/read calls.

More information at https://www.freedesktop.org/software/systemd/man/systemd-resolved.service.html#/etc/resolv.conf

Types ¶

type File ¶

type File struct {
	Content []byte
	Hash    string
}

File contains the resolv.conf content and its hash

func Build ¶

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

Build writes a configuration file to path containing a "nameserver" entry for every element in dns, a "search" entry for every element in dnsSearch, and an "options" entry for every element in dnsOptions.

func FilterResolvDNS ¶

func FilterResolvDNS(resolvConf []byte, ipv6Enabled bool) (*File, error)

FilterResolvDNS cleans up the config in resolvConf. It has two main jobs:

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
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

func Get ¶

func Get() (*File, error)

Get returns the contents of /etc/resolv.conf and its hash

func GetSpecific ¶

func GetSpecific(path string) (*File, error)

GetSpecific returns the contents of the user specified resolv.conf file and its hash

Source Files ¶

View all Source files

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