[or-cvs] Update router descriptor and directory formats (rendezvous ...

[Nick Mathewson]

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

Modified Files:
	tor-spec.txt 
Log Message:
Update router descriptor and directory formats (rendezvous desc format is correct)

Index: tor-spec.txt
===================================================================
RCS file: /home/or/cvsroot/doc/tor-spec.txt,v
retrieving revision 1.55
retrieving revision 1.56
diff -u -d -r1.55 -r1.56
--- tor-spec.txt	10 May 2004 05:57:31 -0000	1.55
+++ tor-spec.txt	10 May 2004 16:57:05 -0000	1.56
@@ -558,16 +558,16 @@
 "router-signature" Item and an extra NL; and MUST contain exactly one
 instance of each of the following Items: "published" "onion-key" "link-key"
 "signing-key".  Additionally, a router descriptor MAY contain any number of
-"accept", "reject", and "opt" Items.
+"accept", "reject", and "opt" Items.  Other than "router" and
+"router-signature", the items may appear in any order.
 
 The items' formats are as follows:
-   "router" nickname address (ORPort SocksPort DirPort bandwidth)?
+   "router" nickname address (ORPort SocksPort DirPort)?
    "ports" ORPort SocksPort DirPort
-   "bandwidth" bandwidth
+   "bandwidth" bandwidth-avg bandwidth-burst
    "platform" string
    "published" YYYY-MM-DD HH:MM:SS
    "onion-key" NL a public key in PEM format
-   "link-key" NL a public key in PEM format
    "signing-key" NL a public key in PEM format
    "accept" string
    "reject" string
@@ -578,7 +578,8 @@
 ORport ::= port where the router listens for routers/proxies (speaking cells)
 SocksPort ::=  where the router listens for applications (speaking socks)
 DirPort ::= where the router listens for directory download requests
-bandwidth ::= maximum bandwidth, in bytes/s
+bandwidth-avg ::= maximum average bandwidth, in bytes/s
+bandwidth-burst ::= maximum bandwidth spike, in bytes/s
 nickname ::= between 1 and 19 alphanumeric characters, case-insensitive.
 
 Bandwidth and ports are required; if they are not included in the router
@@ -589,12 +590,15 @@
 7.2. Directory format
 
 A Directory begins with a "signed-directory" item, followed by one each of
-the following, in any order: "recommended-software".  It may include any
-number of "opt" items.  After these items, a directory includes any number
-of router descriptors, and a singer "directory-signature" item.
+the following, in any order: "recommended-software", "published",
+"running-routers".  It may include any number of "opt" items.  After these
+items, a directory includes any number of router descriptors, and a singer
+"directory-signature" item.
 
     "signed-directory"
+    "published" YYYY-MM-DD HH:MM:SS
     "recommended-software"  comma-separated-version-list
+    "running-routers" comma-separated-nickname-list
     "directory-signature" NL Signature
 
 Note:  The router descriptor for the directory server must appear first.