[or-cvs] r12175: Merge 122 into dir-spec.txt; mark it closed. (in tor/trunk: . doc doc/spec doc/spec/proposals)

nickm at seul.org nickm at seul.org
Thu Oct 25 03:41:25 UTC 2007


Author: nickm
Date: 2007-10-24 23:41:25 -0400 (Wed, 24 Oct 2007)
New Revision: 12175

Modified:
   tor/trunk/
   tor/trunk/doc/TODO
   tor/trunk/doc/spec/dir-spec.txt
   tor/trunk/doc/spec/proposals/000-index.txt
   tor/trunk/doc/spec/proposals/122-unnamed-flag.txt
Log:
 r16134 at catbus:  nickm | 2007-10-24 23:34:59 -0400
 Merge 122 into dir-spec.txt; mark it closed.



Property changes on: tor/trunk
___________________________________________________________________
 svk:merge ticket from /tor/trunk [r16134] on 8246c3cf-6607-4228-993b-4d95d33730f1

Modified: tor/trunk/doc/TODO
===================================================================
--- tor/trunk/doc/TODO	2007-10-25 03:29:11 UTC (rev 12174)
+++ tor/trunk/doc/TODO	2007-10-25 03:41:25 UTC (rev 12175)
@@ -79,8 +79,8 @@
     - 105: Version negotiation for the Tor protocol
     . 111: Prioritize local traffic over relayed.
       - Merge into tor-spec.txt.
-    . 122: Network status entries need an Unnamed flag
-      - Merge into dir-spec.txt
+    o 122: Network status entries need an Unnamed flag
+      o Merge into dir-spec.txt
       o Implement voting side
         o Set Named and Unnamed sensibly
         o Don't reject Unnamed routers.

Modified: tor/trunk/doc/spec/dir-spec.txt
===================================================================
--- tor/trunk/doc/spec/dir-spec.txt	2007-10-25 03:29:11 UTC (rev 12174)
+++ tor/trunk/doc/spec/dir-spec.txt	2007-10-25 03:41:25 UTC (rev 12175)
@@ -965,6 +965,10 @@
    binds X to some other Y'.)  A router is called 'Named' if the router
    believes the given name should be bound to the given key.
 
+   "Unnamed" -- Directory authorities that support naming should vote for a
+   router to be 'Unnamed' if its given nickname is mapped a different
+   identity.
+
    "Running" -- A router is 'Running' if the authority managed to connect to
    it successfully within the last 30 minutes.
 
@@ -1061,6 +1065,17 @@
           _any_ authority, and if all authorities that list it list the same
           nickname.
 
+          - If consensus-method 2 or later is in use, it is also a
+            requirement to be Named that no authority calls the router's
+            identity and nickname pair "Unnamed".
+
+        * If consenuss-method 2 or later is in use, the Unnamed flag is
+          set for a routerstatus if any authorities have voted for a different
+          identities to be Named with that nickname, or if any authority
+          lists that nickname/ID pair as Unnamed.
+
+          (With consenus-method 1, Unnamed is set like any other flag.)
+
         * The version is given as whichever version is listed by the most
           voters, with ties decided in favor of more recent versions.
 
@@ -1077,9 +1092,10 @@
    half) generate and sign the same signed consensus.
 
    To achieve this, authorities list in their votes their supported methods
-   for generating consensuses from votes.  The method described above and
-   implemented in Tor 0.2.0.x is "1".  Later methods will be assigned higher
-   numbers.
+   for generating consensuses from votes.  Later methods will be assigned
+   higher numbers.  Currently recognized methods:
+     "1" -- The first implemented version.
+     "2" -- Added support for the Unnamed flag.
 
    Before generating a consensus, an authority must decide which consensus
    method to use.  To do this, it looks for the highest version number
@@ -1488,27 +1504,26 @@
 
 6.2. Managing naming
 
-   [XXXX rewrite for v3]
-
    In order to provide human-memorable names for individual server
    identities, some directory servers bind names to IDs.  Clients handle
    names in two ways:
 
    When a client encounters a name it has not mapped before:
 
-      If all the live "Naming" network-status documents the client has
-      claim that the name binds to some identity ID, and the client has at
-      least three live network-status documents, the client maps the name to
-      ID.
+      If the consensus lists any router with that name as "Named", or if
+      consensus-method 2 or later is in use and the consensus lists any
+      router with that name as having the "Unnamed" flag, then the name is
+      bound.  (It's bound to the ID listed in the entry with the Named,
+      or to an unknown ID if no name is found.)
 
-   When a user tries to refer to a router with a name that does not have a
-   mapping under the above rules, the implementation SHOULD warn the user.
-   After giving the warning, the implementation MAY use a router that at
-   least one Naming authority maps the name to, so long as no other naming
-   authority maps that name to a different router.  If no Naming authority
-   maps the name to a router, the implementation MAY use any router that
-   advertises the name.
+   When the user refers to a bound name, the implementation SHOULD provide
+   only the router with ID bound to that name, and no other router, even
+   if the router with the right ID can't be found.
 
+   When a user tries to refer to a non-bound name, the implementation SHOULD
+   warn the user. After warning the use, the implementation MAY use any
+   router that advertises the name.
+
    Not every router needs a nickname.  When a router doesn't configure a
    nickname, it publishes with the default nickname "Unnamed".  Authorities
    SHOULD NOT ever mark a router with this nickname as Named; client software

Modified: tor/trunk/doc/spec/proposals/000-index.txt
===================================================================
--- tor/trunk/doc/spec/proposals/000-index.txt	2007-10-25 03:29:11 UTC (rev 12174)
+++ tor/trunk/doc/spec/proposals/000-index.txt	2007-10-25 03:41:25 UTC (rev 12175)
@@ -44,7 +44,7 @@
 119  New PROTOCOLINFO command for controllers [CLOSED]
 120  Suicide descriptors when Tor servers stop [OPEN]
 121  Hidden Service Authentication [OPEN]
-122  Network status entries need a new Unnamed flag [OPEN]
+122  Network status entries need a new Unnamed flag [CLOSED]
 123  Naming authorities automatically create bindings [OPEN]
 
 
@@ -61,7 +61,6 @@
    117  IPv6 exits
    120  Suicide descriptors when Tor servers stop
    121  Hidden Service Authentication
-   122  Network status entries need a new Unnamed flag
    123  Naming authorities automatically create bindings
  ACCEPTED:
    101  Voting on the Tor Directory System
@@ -81,6 +80,7 @@
    108  Base "Stable" Flag on Mean Time Between Failures
    109  No more than one server per IP address
    119  New PROTOCOLINFO command for controllers
+   122  Network status entries need a new Unnamed flag
  SUPERSEDED:
    112  Bring Back Pathlen Coin Weight
  DEAD:

Modified: tor/trunk/doc/spec/proposals/122-unnamed-flag.txt
===================================================================
--- tor/trunk/doc/spec/proposals/122-unnamed-flag.txt	2007-10-25 03:29:11 UTC (rev 12174)
+++ tor/trunk/doc/spec/proposals/122-unnamed-flag.txt	2007-10-25 03:41:25 UTC (rev 12175)
@@ -4,7 +4,7 @@
 Last-Modified: $Date$
 Author: Roger Dingledine
 Created: 04-Oct-2007
-Status: Accepted
+Status: Closed
 
 1. Overview:
 



More information about the tor-commits mailing list