summaryrefslogtreecommitdiff
path: root/doc/tor-spec.txt
diff options
context:
space:
mode:
authorRoger Dingledine <arma@torproject.org>2004-11-27 05:23:59 +0000
committerRoger Dingledine <arma@torproject.org>2004-11-27 05:23:59 +0000
commit7c81603f3ab4c89a130557cd94852ba2193e9c74 (patch)
tree1caad501737b0439ddaa6f87561e692a5a23ded9 /doc/tor-spec.txt
parente5e45fe980b0b45004cc7a32d7896a9b2f1ff6e3 (diff)
downloadtor-7c81603f3ab4c89a130557cd94852ba2193e9c74.tar.gz
tor-7c81603f3ab4c89a130557cd94852ba2193e9c74.zip
document directory interaction a bit better
svn:r2994
Diffstat (limited to 'doc/tor-spec.txt')
-rw-r--r--doc/tor-spec.txt14
1 files changed, 14 insertions, 0 deletions
diff --git a/doc/tor-spec.txt b/doc/tor-spec.txt
index 9d180b4405..0f5c212395 100644
--- a/doc/tor-spec.txt
+++ b/doc/tor-spec.txt
@@ -802,6 +802,20 @@ entries.
lists nodes that are connected currently
speaks http on a socket, spits out directory on request
+Directory servers listen on a certain port (the DirPort), and speak a
+limited version of HTTP 1.0. Clients send either GET or POST commands.
+The basic interactions are:
+ "%s %s HTTP/1.0\r\nContent-Length: %lu\r\nHost: %s\r\n\r\n",
+ command, url, content-length, host.
+ Get "/tor/" to fetch a full directory.
+ Get "/tor/dir.z" to fetch a compressed full directory.
+ Get "/tor/running-routers" to fetch a network-status descriptor.
+ Post "/tor/" to post a server descriptor, with the body of the
+ request containing the descriptor.
+
+ "host" is used to specify the address:port of the dirserver, so
+ the request can survive going through http proxies.
+
A.1. Differences between spec and implementation
- The current specification requires all ORs to have IPv4 addresses, but