package etchosts

import "github.com/docker/docker/libnetwork/etchosts"

Index ¶

• func Add(path string, recs []Record) error
• func Build(path string, extraContent []Record) error
• func BuildNoIPv6(path string, extraContent []Record) error
• func Delete(path string, recs []Record) error
• func Drop(path string)
• func Update(path, IP, hostname string) error
• type Record
• func (r Record) WriteTo(w io.Writer) (int64, error)

Functions ¶

func Add ¶

func Add(path string, recs []Record) error

Add adds an arbitrary number of Records to an already existing /etc/hosts file

func Build ¶

func Build(path string, extraContent []Record) error

Build function path is path to host file string required extraContent is an array of extra host records.

func BuildNoIPv6 ¶

func BuildNoIPv6(path string, extraContent []Record) error

BuildNoIPv6 is the same as Build, but will not include IPv6 entries.

func Delete ¶

func Delete(path string, recs []Record) error

Delete deletes Records from /etc/hosts. The hostnames must be an exact match (if the user has modified the record, it won't be deleted). The address, parsed as a netip.Addr must also match the value in recs.

func Drop ¶

func Drop(path string)

Drop drops the path string from the path cache

func Update ¶

func Update(path, IP, hostname string) error

Update all IP addresses where hostname matches. path is path to host file IP is new IP address hostname is hostname to search for to replace IP

Types ¶

type Record ¶

type Record struct {
	Hosts string
	IP    netip.Addr
}

Record Structure for a single host record

func (Record) WriteTo ¶

func (r Record) WriteTo(w io.Writer) (int64, error)

WriteTo writes record to file and returns bytes written or error

Source Files ¶

etchosts.go