doc: Explain how to avoid inconsistent reads on V3BandwidthsFile

Closes 26702.

diff --git a/doc/tor.1.txt b/doc/tor.1.txt
index f42ad0dd3c87ecb056cc61cf47221110370ce437..1db8cabf86826c87708fcad7c61129fe106fd8c7 100644 (file)
--- a/doc/tor.1.txt
+++ b/doc/tor.1.txt
@@ -2747,7 +2747,9 @@ on the public Tor network.
 [[V3BandwidthsFile]] **V3BandwidthsFile** __FILENAME__::
     V3 authoritative directories only. Configures the location of the
     bandwidth-authority generated file storing information on relays' measured
-    bandwidth capacities. (Default: unset)
+    bandwidth capacities. To avoid inconsistent reads, bandwidth data should
+    be written to temporary file, then renamed to the configured filename.
+    (Default: unset)
 
 [[V3AuthUseLegacyKey]] **V3AuthUseLegacyKey** **0**|**1**::
     If set, the directory authority will sign consensuses not only with its