Ticket #2064: exitlist-spec-2.txt

File exitlist-spec-2.txt, 1.8 KB (added by karsten, 9 years ago)
Line 
1
2                        TorDNSEL Exit List Format
3
4TorDNSEL is an implementation of the active testing, DNS-based exit list
5for Tor exit nodes.  The implementation is available at
6
7  https://www.torproject.org/tordnsel/dist/
8
9The design and its rationale are described in the Tor sources at
10
11  /doc/contrib/torel-design.txt
12
13This document is an attempt to make sense of the exit list format that
14TorDNSEL publishes without the original TorDNSEL author being around.
15
16
17TorDNSEL publishes its exit test results in a single document with entries
18using the following format.  The document consists of an arbitrary number
19of entries each consisting of four or more lines:  (ExitNode | Published |
20LastStatus | ExitAddress*)*.  In the format below, keywords are written in
21double quotes and spaces and newlines are explicitly marked as SP and NL:
22
23  "ExitNode" SP fingerprint NL
24
25    The identity of the relay in upper-case hex characters.  This
26    fingerprint corresponds to the fingerprint in v2 and v3 network status
27    documents as specified in /doc/spec/dir-spec.txt in the Tor sources.
28
29  "Published" SP YYYY-MM-DD SP HH:MM:SS NL
30
31    The publication time, in UTC, of the most recent relay descriptor that
32    was known when the test was initiated.  No further test is initiated
33    until the relay publishes a new descriptor.
34
35  "LastStatus" SP YYYY-MM-DD SP HH:MM:SS NL
36
37    The last time, in UTC, when the relay was seen in a v2 network status
38    document.  A relay is discarded from the list if it was not seen in a
39    network status for at least 48 hours.
40
41  "ExitAddress" SP address SP YYYY-MM-DD SP HH:MM:SS NL
42
43    One or more test results for this relay consisting of the found exit
44    address and the time, in UTC, when the test was performed.  A test is
45    discarded from the list if it is older than 48 hours.
46