From c7b1172618fbeadd0d6236a406697e2a99e58af9 Mon Sep 17 00:00:00 2001 From: Nick Mathewson Date: Thu, 12 Oct 2023 21:36:21 -0400 Subject: Clean up a section of dirspec that looked like html tags. --- spec/dir-spec/general-use-http-urls.md | 67 +++++++++++++++++----------------- 1 file changed, 34 insertions(+), 33 deletions(-) diff --git a/spec/dir-spec/general-use-http-urls.md b/spec/dir-spec/general-use-http-urls.md index d3c68ad..9cd0a02 100644 --- a/spec/dir-spec/general-use-http-urls.md +++ b/spec/dir-spec/general-use-http-urls.md @@ -5,15 +5,15 @@ The most recent v3 consensus should be available at: -http:///tor/status-vote/current/consensus.z +`http:///tor/status-vote/current/consensus.z` Similarly, the v3 microdescriptor consensus should be available at: -http:///tor/status-vote/current/consensus-microdesc.z +`http:///tor/status-vote/current/consensus-microdesc.z` Starting with Tor version 0.2.1.1-alpha is also available at: -http:///tor/status-vote/current/consensus/++.z +`http:///tor/status-vote/current/consensus/++.z` (NOTE: Due to squid proxy url limitations at most 96 fingerprints can be retrieved in a single request.) @@ -35,42 +35,42 @@ that is known to support this URL format. A concatenated set of all the current key certificates should be available at: -http:///tor/keys/all.z +`http:///tor/keys/all.z` The key certificate for this server should be available at: -http:///tor/keys/authority.z +`http:///tor/keys/authority.z` The key certificate for an authority whose authority identity fingerprint -is should be available at: +is `` should be available at: -http:///tor/keys/fp/.z +`http:///tor/keys/fp/.z` -The key certificate whose signing key fingerprint is should be +The key certificate whose signing key fingerprint is `` should be available at: -http:///tor/keys/sk/.z +`http:///tor/keys/sk/.z` -The key certificate whose identity key fingerprint is and whose signing -key fingerprint is should be available at: +The key certificate whose identity key fingerprint is `` and whose signing +key fingerprint is `` should be available at: -http:///tor/keys/fp-sk/-.z +`http:///tor/keys/fp-sk/-.z` (As usual, clients may request multiple certificates using: -http:///tor/keys/fp-sk/-+-.z ) +`http:///tor/keys/fp-sk/-+-.z` ) [The above fp-sk format was not supported before Tor 0.2.1.9-alpha.] The most recent descriptor for a server whose identity key has a -fingerprint of should be available at: +fingerprint of `` should be available at: -http:///tor/server/fp/.z +`http:///tor/server/fp/.z` The most recent descriptors for servers with identity fingerprints -,, should be available at: +``, ``,`` should be available at: -http:///tor/server/fp/++.z +`http:///tor/server/fp/++.z` (NOTE: Due to squid proxy url limitations at most 96 fingerprints can be retrieved in a single request. @@ -80,47 +80,48 @@ fingerprint. This allows a corrupted server (in collusion with a cache) to provide a unique descriptor to a client, and thereby partition that client from the rest of the network.) -The server descriptor with (descriptor) digest (in hex) should be +The server descriptor with (descriptor) digest `` (in hex) should be available at: -http:///tor/server/d/.z +`http:///tor/server/d/.z` -The most recent descriptors with digests ,, should be +The most recent descriptors with digests ``, ``, `` should be available at: -http:///tor/server/d/++.z +`http:///tor/server/d/++.z` The most recent descriptor for this server should be at: -http:///tor/server/authority.z +`http:///tor/server/authority.z` This is used for authorities, and also if a server is configured as a bridge. The official Tor implementations (starting at 0.1.1.x) use this resource to test whether a server's own DirPort -is reachable. It is also useful for debugging purposes. +is reachable. It is also useful for debugging purposes. A concatenated set of the most recent descriptors for all known servers should be available at: -http:///tor/server/all.z +`http:///tor/server/all.z` -Extra-info documents are available at the URLS +Extra-info documents are available at the URLS: ```text http:///tor/extra/d/... http:///tor/extra/fp/... http:///tor/extra/all[.z] http:///tor/extra/authority[.z] - (As for /tor/server/ URLs: supports fetching extra-info - documents by their digest, by the fingerprint of their servers, - or all at once. When serving by fingerprint, we serve the - extra-info that corresponds to the descriptor we would serve by - that fingerprint. Only directory authorities of version - 0.2.0.1-alpha or later are guaranteed to support the first - three classes of URLs. Caches may support them, and MUST - support them if they have advertised "caches-extra-info".) ``` +(These work like the `/tor/server/` URLs: they support fetching extra-info +documents by their digest, by the fingerprint of their servers, +or all at once. When serving by fingerprint, we serve the +extra-info that corresponds to the descriptor we would serve by +that fingerprint. Only directory authorities of version +0.2.0.1-alpha or later are guaranteed to support the first +three classes of URLs. Caches may support them, and MUST +support them if they have advertised "caches-extra-info".) + For debugging, directories SHOULD expose non-compressed objects at URLs like the above, but without the final ".z". If the client uses Accept-Encodings header, it should override the presence or absence -- cgit v1.2.3-54-g00ecf