Ticket #2064: exitlist-spec.txt

File exitlist-spec.txt, 1.5 KB (added by karsten, 9 years ago)

Exit list specification draft

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:
19
20  ExitAddress fingerprint NL
21
22    The identity of the relay in upper-case hex characters. This
23    fingerprint corresponds to the fingerprint in v2 and v3 network status
24    documents as specified in /doc/spec/dir-spec.txt in the Tor sources.
25
26  Published YYYY-MM-DD HH:MM:SS NL
27
28    The publication time, in UTC, of the most recent relay descriptor that
29    was known when the test was initiated. No further test is initiated
30    until the relay publishes a new descriptor.
31
32  LastStatus YYYY-MM-DD HH:MM:SS NL
33
34    The last time, in UTC, when the relay was seen in a v2 network status
35    document. A relay is discarded from the list if it was not seen in a
36    network status for at least 48 hours.
37
38  ExitAddress address YYYY-MM-DD HH:MM:SS NL
39
40    One or more test results for this relay consisting of the found exit
41    address and the time, in UTC, when the test was performed. A test is
42    discarded from the list if it is older than 48 hours.
43