resolver

Documentation

Overview

Package resolver provides the implementation of Penne resolvers

Index

• func MakeResolvers(conf []Config, debug map[string]slog.LogLevel, opts *Options) ([]string, map[string]resolver.Exchanger, error)
• type Config
  • func (rc Config) New(next resolver.Exchanger, opts *Options) (*Resolver, error)
• type Error
  • func (e Error) Error() string
  • func (e Error) Unwrap() error
• type Options
  • func (opts *Options) NewClient(net string) client.Client
  • func (opts *Options) SetDefaults()
• type Resolver
  • func (r *Resolver) Name() string
  • func (r *Resolver) String() string
• type RewriteConfig

Functions

func MakeResolvers

func MakeResolvers(conf []Config, debug map[string]slog.LogLevel,
	opts *Options) ([]string, map[string]resolver.Exchanger, error)

MakeResolvers builds resolvers from a Config slice.

Types

type Config

type Config struct {
	// Name is the unique name of this [Resolver]
	Name string `yaml:""`
	// Next is the name of the resolver to use if the Suffixes restriction
	// isn't satisfied.
	Next string `yaml:",omitempty" toml:",omitempty" json:",omitempty"`

	// Debug indicates the requests passing through this [Resolver] should be logged or not.
	Debug bool `yaml:",omitempty" toml:",omitempty" json:",omitempty"`

	// OmitSubNet indicates requests reaching out to remote servers should omit
	// EDNS0 SUBNET information.
	OmitSubNet bool `yaml:"omit_subnet,omitempty" toml:",omitempty" json:",omitempty"`

	// DisableAAAA indicates that this [Resolver] will discard AAAA entries
	DisableAAAA bool `yaml:"disable_aaaa,omitempty" toml:",omitempty" json:",omitempty"`

	// Iterative indicates that this [Resolver] will go straight to the DNS
	// root servers and ask the authoritative servers for the answers.
	Iterative bool `yaml:",omitempty" toml:",omitempty" json:",omitempty"`

	// Recursive indicates that this [Resolver] will ask servers to perform
	// recursive lookups.
	Recursive bool `yaml:",omitempty" toml:",omitempty" json:",omitempty"`

	// Servers is a list of DNS servers to use for forwarding or iterative resolution.
	// If this [Resolver] is designated as iterative and no servers are provided,
	// a built-in list of root DNS servers will be used.
	Servers []string `yaml:",omitempty" toml:",omitempty" json:",omitempty"`

	// Suffixes indicate what domains will this [Resolver] handle. Globbing patterns allowed.
	Suffixes []string `yaml:",omitempty" toml:",omitempty" json:",omitempty"`

	// Rewrites is a list of query name rewrites to be done by this [Resolver].
	Rewrites []RewriteConfig `yaml:",omitempty" toml:",omitempty" json:",omitempty"`
}

Config describes a Resolver.

func (Config) New

func (rc Config) New(next resolver.Exchanger, opts *Options) (*Resolver, error)

New creates a new Resolver.

type Error

type Error struct {
	Resolver string
	Reason   string
	Err      error
}

Error is an error that references the name of a Resolver

func (Error) Error

func (e Error) Error() string

func (Error) Unwrap

func (e Error) Unwrap() error

type Options

type Options struct {
	Logger slog.Logger

	TLSConfig *tls.Config
}

Options contains information used to assemble all [Resolver]s.

func (*Options) NewClient

func (opts *Options) NewClient(net string) client.Client

NewClient uses the Options to create a new dns.Client.

func (*Options) SetDefaults

func (opts *Options) SetDefaults()

SetDefaults fills any gap in the Options.

type Resolver

type Resolver struct {
	resolver.Exchanger

	Next resolver.Exchanger
	// contains filtered or unexported fields
}

Resolver is a custom resolver.Exchanger.

func (*Resolver) Name

func (r *Resolver) Name() string

Name returns the name of the resolver.

func (*Resolver) String

func (r *Resolver) String() string

type RewriteConfig

type RewriteConfig struct {
	// From is a globbing pattern to match and capture.
	From string `yaml:",omitempty" toml:",omitempty" json:",omitempty"`
	// To is the rewrite template for entries that match the `From` pattern.
	To string `yaml:",omitempty" toml:",omitempty" json:",omitempty"`
	// Final indicates that entries matching this From shouldn't continue
	// to the next rewrite rule.
	Final bool
}

RewriteConfig describes an expression used to alter a request.