diff --git a/docs/abbreviations.md b/docs/abbreviations.md index 50266f5..7aff174 100644 --- a/docs/abbreviations.md +++ b/docs/abbreviations.md @@ -36,3 +36,4 @@ *[ID]: Indentifier *[SSH]: Secure Shell is a cryptographic network protocol for operating network services securely over an unsecured network *[TFTP]: Trivial File Transfer Protocol is a simple lockstep File Transfer Protocol which allows a client to get a file from or put a file onto a remote host +*[TTL]: Time-To-Live is a mechanism that limits the lifespan or lifetime of data in a computer or network diff --git a/docs/ftldns/dns-cache.md b/docs/ftldns/dns-cache.md index a953f92..6bef6df 100644 --- a/docs/ftldns/dns-cache.md +++ b/docs/ftldns/dns-cache.md @@ -1,11 +1,11 @@ -`pihole-FTL` offers an efficient DNS cache that helps speeding up your Internet experience. Setting the cache size to zero disables caching. The DNS TTL value is used for determining the caching period. `pihole-FTL` clears its cache on receiving `SIGHUP`. +`pihole-FTL` offers an efficient DNS cache that helps speed up your Internet experience. This DNS cache is part of the embedded `dnsmasq` server. Setting the cache size to zero disables caching. The DNS TTL value is used for determining the caching period. `pihole-FTL` clears its cache on receiving `SIGHUP`. ### Cache metrics The Settings page (System panel, FTL table) gives live information about the cache usage. It obtains its information from http://pi.hole/admin/api.php?getCacheInfo. #### DNS cache size -Size of the DNS domain cache, defaulting to 10,000 entries. You typically specify this number directly in `/etc/dnsmasq.d/01-pihole.conf`. It is the number of entries that can be actively cached at the same time. There is no benefit in enlarging this number *except* the DNC cache evictions count is larger than zero. +Size of the DNS domain cache, defaulting to 10,000 entries. You typically specify this number directly in `/etc/dnsmasq.d/01-pihole.conf`. It is the number of entries that can be actively cached at the same time. There is no benefit in enlarging this number *except* if the DNS cache evictions count is larger than zero. This information may also be queried using `dig +short chaos txt cachesize.bind` @@ -15,7 +15,7 @@ Number of total insertions into the cache. This number can be substantially larg This information may also be queried using `dig +short chaos txt insertions.bind` #### DNS cache evictions -Number of cache entries that had to be removed although the corresponding entries were **not** expired. Old cache entries get removed when the cache is full at some point to make space for more recent domains. The cache size be increased when this number is larger than zero. +Number of cache entries that had to be removed although the corresponding entries were **not** expired. Old cache entries get removed if the cache is full to make space for more recent domains. The cache size should be increased when this number is larger than zero. This information may also be queried using `dig +short chaos txt evictions.bind`