Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
COREDNS-ERRATIC(7)		CoreDNS	Plugins		    COREDNS-ERRATIC(7)

NAME
       erratic - a plugin useful for testing client behavior.

DESCRIPTION
       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 re-
       sponse (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.

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.

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

READY
       This plugin reports readiness to	the ready plugin.

EXAMPLES
	      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
		  }
	      }

SEE ALSO
       RFC    3849    <https://tools.ietf.org/html/rfc3849>   and   RFC	  5737
       <https://tools.ietf.org/html/rfc5737>.

CoreDNS				  March	2021		    COREDNS-ERRATIC(7)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=coredns-erratic&sektion=7&manpath=FreeBSD+Ports+14.3.quarterly>

home | help