This is an automated email from the ASF dual-hosted git repository.
bcall pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/trafficserver.git
The following commit(s) were added to refs/heads/master by this push:
new 13cd1f187e Clarify hostdb host_file.path reload timing and tip usage
(#12994)
13cd1f187e is described below
commit 13cd1f187e9aab369d9c2eab1f52065b6a2cb8c4
Author: Bryan Call <[email protected]>
AuthorDate: Thu Mar 19 14:44:16 2026 -0700
Clarify hostdb host_file.path reload timing and tip usage (#12994)
Document that host_file.path is reevaluated on the periodic host
file check interval (default 86400s), not on an immediate reload.
Add a tip about temporarily lowering the interval for faster
validation during testing.
---
doc/admin-guide/files/records.yaml.en.rst | 21 +++++++++++++--------
1 file changed, 13 insertions(+), 8 deletions(-)
diff --git a/doc/admin-guide/files/records.yaml.en.rst
b/doc/admin-guide/files/records.yaml.en.rst
index 278af52d64..43bf2ab7bb 100644
--- a/doc/admin-guide/files/records.yaml.en.rst
+++ b/doc/admin-guide/files/records.yaml.en.rst
@@ -3292,14 +3292,19 @@ HostDB
Set the file path for an external host file.
If this is set (non-empty) then the file is presumed to be a hosts file in
- the standard .
- It is read and the entries there added to the HostDB. The file is
- periodically checked for a more recent modification date in which case it is
- reloaded. The interval is set with
:ts:cv:`proxy.config.hostdb.host_file.interval`.
-
- While not technically reloadable, the value is read every time the file is
- to be checked so that if changed the new value will be used on the next
- check and the file will be treated as modified.
+ the standard format. It is read and the entries there are added to HostDB.
+
+ This setting is not immediately reloadable. |TS| checks
+ :ts:cv:`proxy.config.hostdb.host_file.path` during the periodic host file
+ check controlled by :ts:cv:`proxy.config.hostdb.host_file.interval`
+ (default: ``86400`` seconds). If the path value has changed, |TS| uses the
+ new path on that next check and treats the file as modified.
+
+ .. tip::
+
+ For faster pickup during testing, temporarily reduce
+ :ts:cv:`proxy.config.hostdb.host_file.interval`, then restore it after
+ verification.
.. ts:cv:: CONFIG proxy.config.hostdb.host_file.interval INT 86400
:units: seconds
