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 string `yaml:"name"`
	Next string `yaml:"next,omitempty" toml:",omitempty" json:",omitempty"`

	// Debug indicates the requests passing through this [Resolver] should be logged or not.
	Debug bool `yaml:"debug,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 bool     `yaml:"disable_aaaa,omitempty" toml:",omitempty" json:",omitempty"`
	Iterative   bool     `yaml:"iterative,omitempty"    toml:",omitempty" json:",omitempty"`
	Recursive   bool     `yaml:"recursive,omitempty"    toml:",omitempty" json:",omitempty"`
	Servers     []string `yaml:"servers,omitempty"      toml:",omitempty" json:",omitempty"`
	Suffixes    []string `yaml:"suffixes,omitempty"     toml:",omitempty" json:",omitempty"`

	Rewrites []RewriteConfig `yaml:"rewrite,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 string `yaml:"from,omitempty" toml:",omitempty" json:",omitempty"`
	To   string `yaml:"to,omitempty" toml:",omitempty" json:",omitempty"`
}

RewriteConfig describes an expression used to alter a request.