diff options
author | Nick Mathewson <nickm@torproject.org> | 2022-11-15 17:16:56 -0500 |
---|---|---|
committer | Nick Mathewson <nickm@torproject.org> | 2022-11-15 17:16:56 -0500 |
commit | 28d1f6379e99f6e19efb3a7871177ad910094212 (patch) | |
tree | c7ed74aabf73228274f4361bb30ee1f2bef1c714 /dir-spec.txt | |
parent | 5642732fc037aa59199e1250afac1b96b4ed8a28 (diff) | |
download | torspec-28d1f6379e99f6e19efb3a7871177ad910094212.tar.gz torspec-28d1f6379e99f6e19efb3a7871177ad910094212.zip |
Document the extra NL that sometimes comes with a descriptor
This NL isn't so easy to remove in Tor, since some older
control-port code depends on it IIRC. But not having documented it
caused arti#637: let's explain that, so that the next unfortunate
implementor doesn't hit it.
Diffstat (limited to 'dir-spec.txt')
-rw-r--r-- | dir-spec.txt | 6 |
1 files changed, 6 insertions, 0 deletions
diff --git a/dir-spec.txt b/dir-spec.txt index d2f6c4e..d574e3f 100644 --- a/dir-spec.txt +++ b/dir-spec.txt @@ -487,6 +487,12 @@ Table of Contents accepted and ignored. Many of the nonterminals below are defined in section 2.1.3. + Note that many versions of Tor will generate an extra newline at the + end of their descriptors. Implementations MUST tolerate one or + more blank lines at the end of a single descriptor or a list of + concatenated descriptors. New implementations SHOULD NOT generate + such blank lines. + "router" nickname address ORPort SOCKSPort DirPort NL [At start, exactly once.] |