[tor-bugs] #31189 [Core Tor/Tor]: potential docs update needed for GuardLifetime?

[Tor Bug Tracker & Wiki]

#31189: potential docs update needed for GuardLifetime?
-------------------------------------------------+-------------------------
 Reporter:  cypherpunks                          |          Owner:  nickm
     Type:  defect                               |         Status:
                                                 |  needs_review
 Priority:  Medium                               |      Milestone:  Tor:
                                                 |  0.4.2.x-final
Component:  Core Tor/Tor                         |        Version:
 Severity:  Normal                               |     Resolution:
 Keywords:  docs, guardlifetime, 042-should      |  Actual Points:  .1
  BugSmashFund                                   |
Parent ID:                                       |         Points:
 Reviewer:                                       |        Sponsor:
-------------------------------------------------+-------------------------
Changes (by nickm):

 * status:  assigned => needs_review
 * keywords:  docs, guardlifetime, 042-should => docs, guardlifetime,
     042-should BugSmashFund
 * actualpoints:   => .1


Comment:

 > Is the expected behavior that setting UseEntryGuards 1 and GuardLifetime
 1 day will result in guards being used for no longer than one day?

 To be pedantic: if GuardLifetime 1 day is set, then guards will be removed
 from the list of sampled guards 1 day after they are sampled from the
 directory, or 1 day after they are confirmed (first used for a good
 circuit) -- whichever comes first.

 Note that nothing prevents a guard from being re-sampled immediately after
 it is removed: this is intentional, since behaving otherwise would be less
 random.

 It may be that we allow the interval for sampled, unconfirmed guards to be
 configured independently from the interval for confirmed guards.  That's a
 different ticket, though, and we'd have to consider it for 0.4.3.

 I've got a documentation fix against maint-0.3.5 in branch
 `ticket31189_035` with PR at https://github.com/torproject/tor/pull/1381 .
 It is documentation-only, and merges cleanly to master.

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