[tor-bugs] #24818 [Core Tor/Tor]: Make the hard-coded authorities into a separate include file with a standard format

[Tor Bug Tracker & Wiki]

#24818: Make the hard-coded authorities into a separate include file with a
standard format
-------------------------------------------------+-------------------------
 Reporter:  teor                                 |          Owner:  teor
     Type:  enhancement                          |         Status:
                                                 |  needs_review
 Priority:  Medium                               |      Milestone:  Tor:
                                                 |  0.3.3.x-final
Component:  Core Tor/Tor                         |        Version:
 Severity:  Normal                               |     Resolution:
 Keywords:  torspec, tor-dirauth, review-        |  Actual Points:
  group-29                                       |
Parent ID:  #24786                               |         Points:  1
 Reviewer:                                       |        Sponsor:
-------------------------------------------------+-------------------------
Changes (by teor):

 * status:  needs_revision => needs_review


Comment:

 Replying to [comment:12 nickm]:
 > 4c9df2330ff39353ec8ae13459472c3f59102faf:
 >
 > s/attempted parse this file/attempted to parse this file/

 Fixup in 689af75

 > When giving the URLs where the authority list and fallback list can be
 received, we should probably make it clear that automatically fetching
 them is _not_ recommended.

 Do you want to rephrase any of this existing text?

    Libraries SHOULD parse and cache the most recent version of these lists
    during their build or release processes. Libraries MUST NOT retrieve
 the
    lists by default every time they are deployed or executed.

    The latest authority list can be retrieved from:

      https://gitweb.torproject.org/tor.git/plain/src/or/auth_dirs.inc

    The latest fallback list can be retrieved from:

      https://gitweb.torproject.org/tor.git/plain/src/or/fallback_dirs.inc

    Libraries MUST NOT rely on the availability of the server that hosts
    these lists.

 > Otherwise this branch looks good to me.  Do we currently have anything
 that consumes these files, other than our C compiler when we build Tor?
 If not, we should document that fact, since whoever is the first to
 actually parse it based on the documentation will be a surprised person.

 I expect to send the draft spec and formatted file to the tool authors,
 and merge them both after they approve. We have 6-12 months before the
 next fallback list. I'll re-target these tickets to 0.3.4.

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