dnsquery

Documentation

Index

• type Benchmarker
  • func NewBenchmarker(cfg *config.Config) *Benchmarker
  • func (b *Benchmarker) Close()
  • func (b *Benchmarker) Run(ctx context.Context) *analysis.BenchmarkResults
• type QueryOutcome
• type QueryResult
• type ResponseValidationError
  • func (e *ResponseValidationError) Error() string

Types

type Benchmarker

type Benchmarker struct {
	Config  *config.Config
	Results *analysis.BenchmarkResults
	Limiter *rate.Limiter
	// ProgressWriter, when non-nil, receives an in-place progress line during
	// Run (intended for an interactive stderr). Nil disables progress output.
	ProgressWriter io.Writer
	// contains filtered or unexported fields
}

Benchmarker manages the benchmarking process.

func NewBenchmarker

func NewBenchmarker(cfg *config.Config) *Benchmarker

NewBenchmarker creates a new Benchmarker instance.

func (*Benchmarker) Close

func (b *Benchmarker) Close()

Close releases benchmark-scoped resources.

func (*Benchmarker) Run

func (b *Benchmarker) Run(ctx context.Context) *analysis.BenchmarkResults

Run performs the benchmark against the configured servers. Cancelling ctx stops the benchmark early; results collected so far remain valid, with the unattempted queries recorded as skipped.

type QueryOutcome

type QueryOutcome string

QueryOutcome classifies the outcome of a DNS query attempt.

const (
	OutcomeSuccess    QueryOutcome = "success"
	OutcomeDNSFailure QueryOutcome = "dns_failure"
	OutcomeTimeout    QueryOutcome = "timeout"
	OutcomeTransport  QueryOutcome = "transport_error"
	OutcomeMalformed  QueryOutcome = "malformed_response"
)

type QueryResult

type QueryResult struct {
	Latency  time.Duration
	Response *dns.Msg
	Error    error
}

QueryResult holds the result of a single DNS query.

type ResponseValidationError

type ResponseValidationError struct {
	Reason string
}

ResponseValidationError indicates a DNS response failed structural validation (wrong ID, missing Response bit, question mismatch, etc.).

func (*ResponseValidationError) Error

func (e *ResponseValidationError) Error() string