diff --git a/docs/abbreviations.md b/docs/abbreviations.md index a45aa31..31548b7 100644 --- a/docs/abbreviations.md +++ b/docs/abbreviations.md @@ -10,6 +10,7 @@ *[TCP]: Transmission Control Protocol (protocol providing reliable, ordered, and error-checked delivery of data between applications running on hosts communicating via an IP network) *[UDP]: User Datagram Protocol (a network communications method for sending messages as datagrams) *[API]: Application Programming Interface (a set of subroutine definitions, protocols, and tools for building application software) +*[PE]: Privacy Extension *[PID]: Process identifier (a number used to identify a process) *[HOSTS]: The computer file /etc/hosts is an operating system file that maps hostnames to IP addresses *[POSIX]: Portable Operating System Interface (a family of standards specified by the IEEE Computer Society for maintaining compatibility between operating systems) diff --git a/docs/ftldns/configfile.md b/docs/ftldns/configfile.md index 85cab09..205faf6 100755 --- a/docs/ftldns/configfile.md +++ b/docs/ftldns/configfile.md @@ -93,6 +93,17 @@ host name for another IP address (e.g., a DHCP server managed IPv4 address). In this case, we use the host name associated to the other address as this is the same device. +#### `REFRESH_HOSTNAMES=IPV4|ALL|NONE` (PR [#953](https://github.com/pi-hole/FTL/pull/953)) {#refresh_hostnames data-toc-label='Refresh hostnames'} + +With this option, you can change how (and if) hourly PTR requests are made to check for changes in client and upstream server hostnames. The following options are available: + +- `REFRESH_HOSTNAMES=IPV4` - Do the hourly PTR lookups only for IPv4 addresses + This is the new default since Pi-hole FTL v5.3.2. It should resolve issues with more and more very short-lived PE IPv6 addresses coming up in a lot of networks. +- `REFRESH_HOSTNAMES=ALL` - Do the hourly PTR lookups for all addresses + This is the same as what we're doing with FTL v5.3(.1). This can create a lot of PTR queries for those with many IPv6 addresses in their networks. +- `REFRESH_HOSTNAMES=NONE` - Don't do any hourly PTR lookups + This means we look host names up exactly once (when we first see a client) and never again. You may miss future changes of host names. + --- ### Long-term database settings