[tor-commits] [torspec/master] dir-spec: Authorities should only read V3BandwidthsFile once per vote

[nickm at torproject.org]

commit b155c2e13d96c204121503df9e5aa22d30f3f9da
Author: teor <teor2345 at gmail.com>
Date:   Wed Jul 18 11:15:42 2018 +1000

    dir-spec: Authorities should only read V3BandwidthsFile once per vote
    
    Closes 26827.
---
 dir-spec.txt | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/dir-spec.txt b/dir-spec.txt
index 7da4c9a..8da28c4 100644
--- a/dir-spec.txt
+++ b/dir-spec.txt
@@ -2631,6 +2631,10 @@
 
      http://<hostname>/tor/status-vote/next/authority.z
 
+   To avoid inconsistent reads, authorities SHOULD only read the bandwidth
+   file once per voting period. Further processing and serving SHOULD use a
+   cached copy.
+
    The bandwidth list format is described in bandwidth-file-spec.txt.
 
    The standard URLs for bandwidth list files first-appeared in Tor 0.3.5.