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

  
 
  

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 response (ex-
     cept  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 2026		      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+15.1.quarterly>

home | help