hosts

package
v0.9.10 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 3, 2017 License: Apache-2.0 Imports: 17 Imported by: 0

README

hosts

hosts enables serving zone data from a /etc/hosts style file.

The hosts plugin is useful for serving zones from a /etc/hosts file. It serves from a preloaded file that exists on disk. It checks the file for changes and updates the zones accordingly. This plugin only supports A, AAAA, and PTR records. The hosts plugin can be used with readily available hosts files that block access to advertising servers.

Syntax

hosts [FILE [ZONES...]] {
    [INLINE]
    fallthrough
}
  • FILE the hosts file to read and parse. If the path is relative the path from the root directive will be prepended to it. Defaults to /etc/hosts if omitted. We scan the file for changes every 5 seconds.
  • ZONES zones it should be authoritative for. If empty, the zones from the configuration block are used.
  • INLINE the hosts file contents inlined in Corefile. If there are any lines before fallthrough then all of them will be treated as the additional content for hosts file. The specified hosts file path will still be read but entries will be overrided.
  • fallthrough If zone matches and no record can be generated, pass request to the next plugin.

Examples

Load /etc/hosts file.

. {
    hosts
}

Load example.hosts file in the current directory.

hosts example.hosts

Load example.hosts file and only serve example.org and example.net from it and fall through to the next plugin if query doesn't match.

hosts example.hosts example.org example.net {
    fallthrough
}

Load hosts file inlined in Corefile.

hosts example.hosts example.org {
    10.0.0.1 example.org
    fallthrough
}

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Hosts

type Hosts struct {
	Next plugin.Handler
	*Hostsfile

	Fallthrough bool
}

Hosts is the plugin handler

func (Hosts) Name

func (h Hosts) Name() string

Name implements the plugin.Handle interface.

func (Hosts) ServeDNS

func (h Hosts) ServeDNS(ctx context.Context, w dns.ResponseWriter, r *dns.Msg) (int, error)

ServeDNS implements the plugin.Handle interface.

type Hostsfile

type Hostsfile struct {
	sync.RWMutex

	// list of zones we are authoritive for
	Origins []string
	// contains filtered or unexported fields
}

Hostsfile contains known host entries.

func (*Hostsfile) LookupStaticAddr

func (h *Hostsfile) LookupStaticAddr(addr string) []string

LookupStaticAddr looks up the hosts for the given address from the hosts file.

func (*Hostsfile) LookupStaticHostV4

func (h *Hostsfile) LookupStaticHostV4(host string) []net.IP

LookupStaticHostV4 looks up the IPv4 addresses for the given host from the hosts file.

func (*Hostsfile) LookupStaticHostV6

func (h *Hostsfile) LookupStaticHostV6(host string) []net.IP

LookupStaticHostV6 looks up the IPv6 addresses for the given host from the hosts file.

Jump to

Keyboard shortcuts

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