aboutsummaryrefslogtreecommitdiff
path: root/man/coredns-cache.7
diff options
context:
space:
mode:
Diffstat (limited to 'man/coredns-cache.7')
-rw-r--r--man/coredns-cache.78
1 files changed, 5 insertions, 3 deletions
diff --git a/man/coredns-cache.7 b/man/coredns-cache.7
index 3e9fce656..a7e41a477 100644
--- a/man/coredns-cache.7
+++ b/man/coredns-cache.7
@@ -63,10 +63,10 @@ cache [TTL] [ZONES\.\.\.] {
.IP "" 0
.
.SH "CAPACITY AND EVICTION"
-When specifying \fBCAPACITY\fR, the minimum cache capacity is 131,072\. Specifying a lower value will be ignored\. Specifying a \fBCAPACITY\fR of zero does not disable the cache\.
+If \fBCAPACITY\fR is not specified, the default cache size is 10,000 per cache\. The minimum allowed cache size is 1024\.
.
.P
-Eviction is done per shard \- i\.e\. when a shard reaches capacity, items are evicted from that shard\. Since shards don\'t fill up perfectly evenly, evictions will occur before the entire cache reaches full capacity\. Each shard capacity is equal to the total cache size / number of shards (256)\.
+Eviction is done per shard\. In effect, when a shard reaches capacity, items are evicted from that shard\. Since shards don\'t fill up perfectly evenly, evictions will occur before the entire cache reaches full capacity\. Each shard capacity is equal to the total cache size / number of shards (256)\. Eviction is random, not TTL based\. Entries with 0 TTL will remain in the cache until randomly evicted when the shard reaches capacity\.
.
.SH "METRICS"
If monitoring is enabled (via the \fIprometheus\fR directive) then the following metrics are exported:
@@ -119,4 +119,6 @@ Proxy to Google Public DNS and only cache responses for example\.org (or below)\
.fi
.
.IP "" 0
-
+.
+.P
+Enable caching for all zones, keep a positive cache size of 5000 and a negative cache size of 2500: ~~~ corefile \. { cache { success 5000 denial 2500 } } ~~~