mirror of
https://gitlab.torproject.org/tpo/core/tor.git
synced 2024-11-10 13:13:44 +01:00
Comments from cat: "space" should include or exclude tabs. We include tabs, so specify that.
svn:r5635
This commit is contained in:
parent
9afeacac3b
commit
4417017197
@ -117,12 +117,15 @@ $Id$
|
||||
for clarity between sections; these blank lines are ignored.
|
||||
Implementations MUST NOT depend on blank lines in any particular location.
|
||||
|
||||
As used here, "whitespace" is a sequence of 1 or more tab or space
|
||||
characters.
|
||||
|
||||
The preamble contains:
|
||||
|
||||
"network-status-version" -- A document format version. For this
|
||||
specification, the version is "2".
|
||||
"dir-source" -- The authority's hostname, current IP address, and
|
||||
directory port, all separated by spaces.
|
||||
directory port, all separated by whitespace.
|
||||
"fingerprint" -- A base16-encoded hash of the signing key's
|
||||
fingerprint, with no additional spaces added.
|
||||
"contact" -- An arbitrary string describing how to contact the
|
||||
@ -134,7 +137,7 @@ $Id$
|
||||
"server-versions" -- A comma-separated list of recommended server
|
||||
versions.
|
||||
"published" -- The publication time for this network-status object.
|
||||
"dir-options" -- A set of flags separated by spaces:
|
||||
"dir-options" -- A set of flags, in any order, separated by whitespace:
|
||||
"Names" if this directory authority performs name bindings.
|
||||
"Versions" if this directory authority recommends software versions.
|
||||
|
||||
@ -148,7 +151,8 @@ $Id$
|
||||
For each router, the router entry contains: (This format is designed for
|
||||
conciseness.)
|
||||
|
||||
"r" -- followed by the following elements, separated by spaces:
|
||||
"r" -- followed by the following elements, in order, separated by
|
||||
whitespace:
|
||||
- The OR's nickname,
|
||||
- A hash of its identity key, encoded in base64, with trailing =
|
||||
signs removed.
|
||||
@ -160,7 +164,7 @@ $Id$
|
||||
- An IP address
|
||||
- An OR port
|
||||
- A directory port (or "0" for none")
|
||||
"s" -- A series of space-separated status flags:
|
||||
"s" -- A series of whitespace-separated status flags, in any order:
|
||||
"Authority" if the router is a directory authority.
|
||||
"Exit" if the router is useful for building general-purpose exit
|
||||
circuits.
|
||||
|
@ -675,7 +675,7 @@ extensible information format.
|
||||
|
||||
The highest level object is a Document, which consists of one or more Items.
|
||||
Every Item begins with a KeywordLine, followed by one or more Objects. A
|
||||
KeywordLine begins with a Keyword, optionally followed by a space and more
|
||||
KeywordLine begins with a Keyword, optionally followed by whitespace and more
|
||||
non-newline characters, and ends with a newline. A Keyword is a sequence of
|
||||
one or more characters in the set [A-Za-z0-9-]. An Object is a block of
|
||||
encoded data in pseudo-Open-PGP-style armor. (cf. RFC 2440)
|
||||
@ -684,10 +684,11 @@ More formally:
|
||||
|
||||
Document ::= (Item | NL)+
|
||||
Item ::= KeywordLine Object*
|
||||
KeywordLine ::= Keyword NL | Keyword SP ArgumentsChar+ NL
|
||||
KeywordLine ::= Keyword NL | Keyword WS ArgumentsChar+ NL
|
||||
Keyword = KeywordChar+
|
||||
KeywordChar ::= 'A' ... 'Z' | 'a' ... 'z' | '0' ... '9' | '-'
|
||||
ArgumentChar ::= any printing ASCII character except NL.
|
||||
WS = (SP | TAB)+
|
||||
Object ::= BeginLine Base-64-encoded-data EndLine
|
||||
BeginLine ::= "-----BEGIN " Keyword "-----" NL
|
||||
EndLine ::= "-----END " Keyword "-----" NL
|
||||
@ -748,7 +749,7 @@ The items' formats are as follows:
|
||||
"fingerprint"
|
||||
|
||||
A fingerprint (20 byte SHA1 hash of asn1 encoded public key, encoded
|
||||
in hex, with spaces after every 4 characters) for this router's
|
||||
in hex, with a single space after every 4 characters) for this router's
|
||||
identity key.
|
||||
|
||||
[We didn't start parsing this line until Tor 0.1.0.6-rc; it should
|
||||
@ -798,9 +799,9 @@ The items' formats are as follows:
|
||||
|
||||
"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.
|
||||
'Names' is a whitespace-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
|
||||
@ -859,7 +860,7 @@ descriptors, and a single "directory-signature" item.
|
||||
A list of which versions of which implementations are currently
|
||||
believed to be secure and compatible with the network.
|
||||
|
||||
"running-routers" space-separated-list
|
||||
"running-routers" whitespace-separated-list
|
||||
|
||||
A description of which routers are currently believed to be up or
|
||||
down. Every entry consists of an optional "!", followed by either an
|
||||
@ -873,7 +874,7 @@ descriptors, and a single "directory-signature" item.
|
||||
backward compatibility. New code should parse 'router-status'
|
||||
instead.]
|
||||
|
||||
"router-status" space-separated-list
|
||||
"router-status" whitespace-separated-list
|
||||
|
||||
A description of which routers are currently believed to be up or
|
||||
down, and which are verified or unverified. Contains one entry for
|
||||
|
Loading…
Reference in New Issue
Block a user