[or-cvs] Update tor-spec.txt: list and describe all router and direc...

[Nick Mathewson]

Update of /home/or/cvsroot/tor/doc
In directory moria.mit.edu:/tmp/cvs-serv28664/doc

Modified Files:
	tor-spec.txt TODO 
Log Message:
Update tor-spec.txt: list and describe all router and directory fields.

Index: tor-spec.txt
===================================================================
RCS file: /home/or/cvsroot/tor/doc/tor-spec.txt,v
retrieving revision 1.72
retrieving revision 1.73
diff -u -d -r1.72 -r1.73
--- tor-spec.txt	27 Nov 2004 05:23:59 -0000	1.72
+++ tor-spec.txt	30 Nov 2004 04:19:25 -0000	1.73
@@ -662,7 +662,7 @@
 
    "uptime"
 
-      The number of seconds that this OR has been running.
+      The number of seconds that this OR process has been running.
 
    "onion-key" NL a public key in PEM format
 
@@ -689,6 +689,41 @@
        The router descriptor is invalid unless the signature is performed
        with the router's identity key.
 
+   "dircacheport" port NL
+
+       Same as declaring "port" as this OR's directory port in the 'router'
+       line. At most one of dircacheport and the directory port in the router
+       line.
+
+       [Obsolete; will go away once 0.0.8 is dead. Older version of Tor
+       did poorly when non-authoritative directories has a non-0 directory
+       port.  To transition, Tor 0.0.8 used dircacheport for
+       nonauthoritative directories.]
+
+   "contact" info NL
+
+       Describes a way to contact the server's administrator, preferably
+       including an email address and a PGP key fingerprint.
+
+   "family" names NL
+
+       'Names' is a space-separated list of server nicknames.  If two ORs
+       list one another in their "family" entries, then OPs should treat
+       them as a single OR for the purpose of path selection.
+
+       For example, if node A's descriptor contains "family B", and node B's
+       descriptor contains "family A", then node A and node B should never
+       be used on the same circuit.
+
+   "read-history" YYYY-MM-DD HH:MM:SS (NSEC s) NUM,NUM,NUM,NUM,NUM... NL
+   "write-history" YYYY-MM-DD HH:MM:SS (NSEC s) NUM,NUM,NUM,NUM,NUM... NL
+
+       Declare how much bandwidth the OR has used recently. Usage is divided
+       into intervals of NSEC seconds.  The YYYY-MM-DD HH:MM:SS field defines
+       the end of the most recent interval.  The numbers list the number of
+       bytes used in the most recent intervals, ordered from oldest to newest.
+
+
 nickname ::= between 1 and 19 alphanumeric characters, case-insensitive.
 
 exitpattern ::= addrspec ":" portspec
@@ -710,9 +745,9 @@
 
 A Directory begins with a "signed-directory" item, followed by one each of
 the following, in any order: "recommended-software", "published",
-"router-status".  It may include any number of "opt" items.  After these
-items, a directory includes any number of router descriptors, and a single
-"directory-signature" item.
+"router-status", "directory-signing-key".  It may include any number of "opt"
+items.  After these items, a directory includes any number of router
+descriptors, and a single "directory-signature" item.
 
     "signed-directory"
 
@@ -722,6 +757,10 @@
 
         The time at which this directory was generated and signed, in GMT.
 
+    "directory-signing-key" 
+
+        The key used to sign this directory; see "signing-key".
+
     "recommended-software"  comma-separated-version-list
 
         A list of which versions of which implementations are currently
@@ -733,7 +772,7 @@
         down.  Every entry consists of an optional "!", followed by either an
         OR's nickname, or "$" followed by a hexadecimal encoding of the hash
         of an OR's identity key.  If the "!" is included, the router is
-        believed to be running; otherwise, it is believed not to be running.
+        believed not to be running; otherwise, it is believed to be running.
         If a router's nickname is given, exactly one router of that nickname
         will appear in the directory, and that router is "approved" by the
         directory server.  If a hashed identity key is given, that OR is not

Index: TODO
===================================================================
RCS file: /home/or/cvsroot/tor/doc/TODO,v
retrieving revision 1.231
retrieving revision 1.232
diff -u -d -r1.231 -r1.232
--- TODO	30 Nov 2004 02:23:50 -0000	1.231
+++ TODO	30 Nov 2004 04:19:25 -0000	1.232
@@ -11,7 +11,7 @@
         X Abandoned
 
 For 0.0.9:
-N&R- bring tor-spec up to date
+N&R. bring tor-spec up to date
    o cache and serve running-routers on other nodes?
      o cache running-routers
      o download running-routers from servers running rc5-cvs or later