[tor-bugs] #11007 [Tor]: Add more documentation about EntryGuardAddedBy in the state file (was: Add more documentation about the state file)

[Tor Bug Tracker & Wiki]

#11007: Add more documentation about EntryGuardAddedBy in the state file
-----------------------------+-----------------
     Reporter:  cypherpunks  |      Owner:
         Type:  defect       |     Status:  new
     Priority:  normal       |  Milestone:
    Component:  Tor          |    Version:
   Resolution:               |   Keywords:
Actual Points:               |  Parent ID:
       Points:               |
-----------------------------+-----------------
Description changed by nickm:

Old description:

> Document better how EntryGuardAddedBy date is calculated and wroten in
> the state file (well, more documentation about all the state file would
> be also good).
> Change also the way the date is calculated?
>
> The EntryGuardAddedBy dates in the state file are not sequential because
> the date is calculated as the real date minus a random date between the
> real and 30 days before  [1].
> The reason for this is to don't reveal the real date the user was online
> at that date to that entry guard.
>
> The only existent documentation is in doc/state-contents.txt
>

> [1]         e->chosen_on_date = time(NULL) - crypto_rand_int(3600*24*30);

New description:

 Document better how EntryGuardAddedBy date is calculated and written in
 the state file (well, more documentation about all the state file would be
 also good).

 Should we also change the way the date is calculated?

 The EntryGuardAddedBy dates in the state file are not sequential because
 the date is calculated as the real date minus a random date between the
 real and 30 days before  [1].

 The reason for this is to avoid revealing the real date the user was
 online at that date to that entry guard.

 The only existent documentation is in doc/state-contents.txt


 [1]         e->chosen_on_date = time(NULL) - crypto_rand_int(3600*24*30);

--

--
Ticket URL: <https://trac.torproject.org/projects/tor/ticket/11007#comment:1>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online