Opened 6 years ago

Closed 6 years ago

#8913 closed defect (fixed)

update v3 dir spec to say that v2 is obsolete

Reported by: arma Owned by:
Priority: Medium Milestone: Tor: 0.2.5.x-final
Component: Core Tor/Tor Version:
Severity: Keywords: tor-spec
Cc: Actual Points:
Parent ID: Points:
Reviewer: Sponsor:

Description

the v3 dir spec says

   Caches and authorities must still support older versions of the
   directory protocols, until the versions of Tor that require them are
   finally out of commission.

which implies that the existing directory authorities are still answering v2 requests (e.g. network statuses). In fact they're not. And the caches haven't been for even longer.

dir-spec-v2.txt should probably go to the attic too.

Child Tickets

Change History (5)

comment:1 Changed 6 years ago by arma

atagar points out that the control protocol still lets you ask for stuff in v2-formatted ways, and I believe that is still working. So maybe not all of v2 is in the attic yet.

comment:2 Changed 6 years ago by nickm

Status: newneeds_review

See branch "bug8913" in my public torspec repository; please review; I'll merge it if nobody objects, I swear I will.

If you want it to say something different, please express that as a patch; I sense bikesheds ahead.

comment:3 Changed 6 years ago by karsten

Changes in your bug8913 branch look good.

Two more suggestions:

  • So far, the V2Dir flag was specified as "version 2" and really meant "version 2 or higher" because the V3Dir flag was never used, right? Now that version 2 is gone, should it at least say "version 2 or higher"? It's mentioned twice in dir-spec, in 3.4.1 "Vote and consensus status document formats" and 3.4.2 "Assigning flags in a vote".
  • Section 7 "Backward compatibility and migration plans" is pretty much obsolete by now. We could as well remove it in the course of removing v2 stuff.

See my bug8913 branch that contains the changes suggested here.

comment:4 in reply to:  1 Changed 6 years ago by karsten

Replying to arma:

atagar points out that the control protocol still lets you ask for stuff in v2-formatted ways, and I believe that is still working. So maybe not all of v2 is in the attic yet.

Moving this discussion to new ticket #10837.

comment:5 Changed 6 years ago by nickm

Resolution: fixed
Status: needs_reviewclosed

Merged this; thanks!

Note: See TracTickets for help on using tickets.