[tor-commits] [torspec/master] merge prop227 into dir-spec

[nickm at torproject.org]

commit ab6453476066fd1bf5c8cb577863c0cdd5079e0f
Author: Nick Mathewson <nickm at torproject.org>
Date:   Fri Feb 27 11:40:47 2015 -0500

    merge prop227 into dir-spec
---
 dir-spec.txt                                   |   33 ++++++++++++++++++++++++
 proposals/000-index.txt                        |    4 +--
 proposals/227-vote-on-package-fingerprints.txt |    3 ++-
 3 files changed, 37 insertions(+), 3 deletions(-)

diff --git a/dir-spec.txt b/dir-spec.txt
index 85492e9..b844c30 100644
--- a/dir-spec.txt
+++ b/dir-spec.txt
@@ -1425,6 +1425,30 @@
         version-spec.txt. If absent, no opinion is held about server
         versions.
 
+    "package" SP PackageName SP Version SP URL SP DIGESTS NL
+
+        [Any number of times.]
+
+        For this element:
+
+        PACKAGENAME = NONSPACE
+        VERSION = NONSPACE
+        URL = NONSPACE
+        DIGESTS = DIGEST | DIGESTS SP DIGEST
+        DIGEST = DIGESTTYPE "=" DIGESTVAL
+        NONSPACE = one or more non-space printing characters
+        DIGESTVAL = DIGESTTYPE = one or more non-=, non-" " characters.
+
+        Indicates that a package called "package" of version VERSION may be
+        found at URL, and its digest as computed with DIGESTTYPE is equal to
+        DIGESTVAL.  In consensuses, these lines are sorted lexically by
+        "PACKAGENAME VERSION" pairs, and DIGESTTYPES must appear in ascending
+        order.  A consensus must not contain the same "PACKAGENAME VERSION"
+        more than once.  If a vote contains the same "PACKAGENAME VERSION"
+        more than once, all but the last is ignored.
+
+        Included in consensuses only for method 19 and later.
+
     "known-flags" SP FlagList NL
 
         [Exactly once.]
@@ -2050,6 +2074,13 @@
      by more than half of the voting authorities that included a
      client-versions or server-versions lines in their votes.
 
+     With consensus method 19 or later, a package line is generated for a
+     given PACKAGENAME/VERSION pair if at least three authorities list such a
+     package in their votes.  (Call these lines the "input" lines for
+     PACKAGENAME.)  The consensus will contain every "package" line that is
+     listed verbatim by more than half of the authorities listing a line for
+     the PACKAGENAME/VERSION pair, and no others.
+
      The authority item groups (dir-source, contact, fingerprint,
      vote-digest) are taken from the votes of the voting
      authorities. These groups are sorted by the digests of the
@@ -2179,6 +2210,8 @@
      "16" -- Adds ntor keys to microdescriptors
      "17" -- Adds "Unmeasured=1" flags to "w" lines
      "18" -- Adds 'id' to microdescriptors.
+     "19" -- Adds "package" lines to consensuses
+     "20" -- Adds GuardFraction information to microdescriptors.
 
    Before generating a consensus, an authority must decide which consensus
    method to use.  To do this, it looks for the highest version number
diff --git a/proposals/000-index.txt b/proposals/000-index.txt
index 63317e1..81d52af 100644
--- a/proposals/000-index.txt
+++ b/proposals/000-index.txt
@@ -147,7 +147,7 @@ Proposals by number:
 224  Next-Generation Hidden Services in Tor [DRAFT]
 225  Strawman proposal: commit-and-reveal shared rng [DRAFT]
 226  "Scalability and Stability Improvements to BridgeDB: Switching to a Distributed Database System and RDBMS" [OPEN]
-227  Include package fingerprints in consensus documents [FINISHED]
+227  Include package fingerprints in consensus documents [CLOSED]
 228  Cross-certifying identity keys with onion keys [OPEN]
 229  Further SOCKS5 extensions [DRAFT]
 230  How to change RSA1024 relay identity keys [DRAFT]
@@ -240,7 +240,6 @@ Proposals by status:
    162  Publish the consensus in multiple flavors [in 0.2.3.1-alpha]
    204  Subdomain support for Hidden Service addresses
    217  Tor Extended ORPort Authentication [for 0.2.5.x]
-   227  Include package fingerprints in consensus documents
    232  Pluggable Transport through SOCKS proxy [in 0.2.6]
    235  Stop assigning (and eventually supporting) the Named flag [in 0.2.6, 0.2.7]
  CLOSED:
@@ -299,6 +298,7 @@ Proposals by status:
    218  Controller events to better understand connection/circuit usage [in 0.2.5.2-alpha]
    221  Stop using CREATE_FAST [for 0.2.5.x]
    222  Stop sending client timestamps [in 0.2.4.18]
+   227  Include package fingerprints in consensus documents [in 0.2.6.3-alpha]
  SUPERSEDED:
    112  Bring Back Pathlen Coin Weight
    113  Simplifying directory authority administration
diff --git a/proposals/227-vote-on-package-fingerprints.txt b/proposals/227-vote-on-package-fingerprints.txt
index d1f9bf7..8839941 100644
--- a/proposals/227-vote-on-package-fingerprints.txt
+++ b/proposals/227-vote-on-package-fingerprints.txt
@@ -2,7 +2,8 @@ Filename: 227-vote-on-package-fingerprints.txt
 Title: Include package fingerprints in consensus documents
 Author: Nick Mathewson, Mike Perry
 Created: 2014-02-14
-Status: Finished
+Status: Closed
+Implemented-In: 0.2.6.3-alpha
 
 0. Abstract