GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
COREDNS-ERRATIC(7) CoreDNS Plugins COREDNS-ERRATIC(7)

erratic - a plugin useful for testing client behavior.

erratic returns a static response to all queries, but the responses can be delayed, dropped or truncated. The erratic plugin will respond to every A or AAAA query. For any other type it will return a SERVFAIL response (except AXFR). The reply for A will return 192.0.2.53 (RFC 5737 ⟨https://tools.ietf.org/html/rfc5737⟩), for AAAA it returns 2001:DB8::53 (RFC 3849 ⟨https://tools.ietf.org/html/rfc3849⟩). For an AXFR request it will respond with a small zone transfer.

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.

In case of a zone transfer and truncate the final SOA record isn't added to the response.

This plugin reports readiness to the ready plugin.

example.org {
    erratic {
        drop 3
    }
}

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

example.org {
    erratic
}

Delay 1 in 3 queries for 50ms

example.org {
    erratic {
        delay 3 50ms
    }
}

Delay 1 in 3 and truncate 1 in 5.

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

Drop every second query.

example.org {
    erratic {
        drop 2
        truncate 2
    }
}

RFC 3849 ⟨https://tools.ietf.org/html/rfc3849⟩ and RFC 5737 ⟨https://tools.ietf.org/html/rfc5737⟩.

March 2021 CoreDNS

Search for    or go to Top of page |  Section 7 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.