nihilist/tor
1
0
Fork 0
mirror of https://gitlab.torproject.org/tpo/core/tor.git synced 2024-11-13 06:33:44 +01:00
Code Issues Packages Projects Releases Wiki Activity

r11692@Kushana: nickm | 2006-12-23 22:32:41 -0500

Browse Source 
Changes to dir-spec.txt: deprecate opt, and describe protocol version info in status.


svn:r9179
This commit is contained in:
Nick Mathewson 2006-12-24 04:09:39 +00:00
parent baac5389a1
commit 42f6c99392
1 changed files with 24 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

31
doc/dir-spec.txt
View File

@ -108,13 +108,21 @@ $Id$
The BeginLine and EndLine of an Object must use the same keyword. The BeginLine and EndLine of an Object must use the same keyword.
When interpreting a Document, software MUST reject any document containing a When interpreting a Document, software MUST ignore any KeywordLine that
KeywordLine that starts with a keyword it doesn't recognize. starts with a keyword it doesn't recognize; future implementations MUST NOT
require current clients to understand any KeywordLine not currently
described.
The "opt" keyword is reserved for non-critical future extensions. All The "opt" keyword was used until Tor 0.1.2.5-alpha for non-critical future
implementations MUST ignore any item of the form "opt keyword ....." when extensions. All implementations MUST ignore any item of the form "opt
they would not recognize "keyword ....."; and MUST treat "opt keyword ....." keyword ....." when they would not recognize "keyword ....."; and MUST
as synonymous with "keyword ......" when keyword is recognized. treat "opt keyword ....." as synonymous with "keyword ......" when keyword
is recognized.
Implementations before 0.1.2.5-alpha rejected any document with a
KeywordLine that started with a keyword that they didn't recognize.
Implementations MUST prefix items not recognized by older versions of Tor
with an "opt" until those versions of Tor are obsolete.
2. Router operation 2. Router operation
@ -378,11 +386,20 @@ $Id$
"Running" if the router is currently usable. "Running" if the router is currently usable.
"Valid" if the router has been 'validated'. "Valid" if the router has been 'validated'.
"V2Dir" if the router implements this protocol. "V2Dir" if the router implements this protocol.
"v" -- The version of the Tor protocol that this server is running. If
the value begins with "Tor" SP, the rest of the string is a Tor
version number, and the protocol is "The Tor protocol as supported
by the given version of Tor." Otherwise, if the value begins with
some other string, Tor has upgraded to a more sophisticated
protocol versioning system, and the protocol is "a version of the
Tor protocol more recent than any we recognize."
The "r" entry for each router must appear first and is required. The The "r" entry for each router must appear first and is required. The
"s" entry is optional (see Section 3.1 below for how the flags are "s" entry is optional (see Section 3.1 below for how the flags are
decided). Unrecognized flags on the "s" line and extra elements decided). Unrecognized flags on the "s" line and extra elements
on the "r" line must be ignored. on the "r" line must be ignored. The "v" line is optional; it was not
supported until 0.1.2.5-alpha, and it must be preceded with an "opt"
until all earlier versions of Tor are obsolete.
The signature section contains: The signature section contains: