erratic

README

erratic

erratic is a middleware useful for testing client behavior. It returns a static response to all queries, but the responses can be delayed, dropped or truncated.

The erratic middleware will respond to every A or AAAA query. For any other type it will return a SERVFAIL response. The reply for A will return 192.0.2.53 (see RFC 5737), for AAAA it returns 2001:DB8::53 (see RFC 3849).

erratic can also be used in conjunction with the autopath middleware. This is mostly to aid in testing.

Syntax

erratic {
    drop [AMOUNT]
    truncate [AMOUNT]
    delay [AMOUNT [DURATION]]
}

• drop: drop 1 per AMOUNT of queries, the default is 2.
• truncate: truncate 1 per AMOUNT of queries, the default is 2.
• delay: delay 1 per AMOUNT of queries for DURATION, the default for AMOUNT is 2 and the default for DURATION is 100ms.

Examples

.:53 {
    erratic {
        drop 3
    }
}

Or even shorter if the defaults suits you. Note this only drops queries, it does not delay them.

. {
    erratic
}

Delay 1 in 3 queries for 50ms

. {
    erratic {
        delay 3 50ms
    }
}

Delay 1 in 3 and truncate 1 in 5.

. {
    erratic {
        delay 3 5ms
        truncate 5
    }
}

Drop every second query.

. {
    erratic {
        drop 2
        truncate 2
    }
}

Documentation

Overview

Package erratic implements a middleware that returns erratic answers (delayed, dropped).

Index

• type Erratic
  • func (e *Erratic) AutoPath(state request.Request) []string
  • func (e *Erratic) Name() string
  • func (e *Erratic) ServeDNS(ctx context.Context, w dns.ResponseWriter, r *dns.Msg) (int, error)

Types

type Erratic

type Erratic struct {
	// contains filtered or unexported fields
}

Erratic is a middleware that returns erratic repsonses to each client.

func (*Erratic) AutoPath

func (e *Erratic) AutoPath(state request.Request) []string

AutoPath implements the AutoPathFunc call from the autopath middleware.

func (*Erratic) Name

func (e *Erratic) Name() string

Name implements the Handler interface.

func (*Erratic) ServeDNS

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

ServeDNS implements the middleware.Handler interface.