[tor-commits] [torspec/master] Move description of read-history and write-history to extrainfo

dgoulet at torproject.org dgoulet at torproject.org
Mon Jul 13 19:24:58 UTC 2020


commit 8729838399814f1baec4e754cec48fc141660864
Author: Nick Mathewson <nickm at torproject.org>
Date:   Mon Jul 13 11:08:51 2020 -0400

    Move description of read-history and write-history to extrainfo
    
    We moved the fields to extrainto back in 0.2.0.x, which is now
    long-obsolete -- it's time to move the description of the fields
    there, and remove the legacy migration note.
---
 dir-spec.txt | 32 +++++++-------------------------
 1 file changed, 7 insertions(+), 25 deletions(-)

diff --git a/dir-spec.txt b/dir-spec.txt
index 626b9ce..1748e5a 100644
--- a/dir-spec.txt
+++ b/dir-spec.txt
@@ -703,16 +703,8 @@
     "write-history" YYYY-MM-DD HH:MM:SS (NSEC s) NUM,NUM,NUM,NUM,NUM... NL
         [At most once]
 
-        Declare how much bandwidth the OR has used recently. Usage is divided
-        into intervals of NSEC seconds.  The YYYY-MM-DD HH:MM:SS field
-        defines the end of the most recent interval.  The numbers are the
-        number of bytes used in the most recent intervals, ordered from
-        oldest to newest.
-
-        [We didn't start parsing these lines until Tor 0.1.0.6-rc; they should
-         be marked with "opt" until earlier versions of Tor are obsolete.]
-
-        [See also migration notes in section 2.1.2.1.]
+        (These fields once appeared in router descriptors, but have
+        appeared in extrainfo descriptors since 0.2.0.x.)
 
     "eventdns" bool NL
 
@@ -876,8 +868,11 @@
     "write-history" YYYY-MM-DD HH:MM:SS (NSEC s) NUM,NUM,NUM,NUM,NUM... NL
         [At most once.]
 
-        As documented in section 2.1.1 above.  See migration notes in
-        section 2.1.2.1.
+        Declare how much bandwidth the OR has used recently. Usage is divided
+        into intervals of NSEC seconds.  The YYYY-MM-DD HH:MM:SS field
+        defines the end of the most recent interval.  The numbers are the
+        number of bytes used in the most recent intervals, ordered from
+        oldest to newest.
 
     "geoip-db-digest" Digest NL
         [At most once.]
@@ -1294,19 +1289,6 @@
         initial item "extra-info" and the final item "router-signature",
         signed with the router's identity key.
 
-2.1.2.1. Moving history fields to extra-info documents
-
-   Tools that want to use the read-history and write-history values SHOULD
-   download extra-info documents as well as server descriptors.  Such
-   tools SHOULD accept history values from both sources; if they appear in
-   both documents, the values in the extra-info documents are authoritative.
-
-   New versions of Tor no longer generate server descriptors
-   containing read-history or write-history.  Tools should continue to
-   accept read-history and write-history values in server descriptors
-   produced by older versions of Tor until all Tor versions earlier
-   than 0.2.0.x are obsolete.
-
 2.1.3. Nonterminals in server descriptors
 
    nickname ::= between 1 and 19 alphanumeric characters ([A-Za-z0-9]),





More information about the tor-commits mailing list