TorDNSEL Exit List Format
TorDNSEL is an implementation of the active testing, DNS-based exit list
for Tor exit nodes. The implementation is available at
https://www.torproject.org/tordnsel/dist/
The design and its rationale were described in the Tor sources, see
https://gitweb.torproject.org/tordnsel.git/blob/HEAD:/doc/torel-design.txt
This document is an attempt to make sense of the exit list format that
TorDNSEL publishes without the original TorDNSEL author being around.
TorDNSEL publishes its exit test results in a single document with entries
using the following format. The document consists of an arbitrary number
of entries each consisting of four or more lines: (ExitNode | Published |
LastStatus | ExitAddress*)*. In the format below, keywords are written in
double quotes and spaces and newlines are explicitly marked as SP and NL:
"ExitNode" SP fingerprint NL
The identity of the relay in upper-case hex characters. This
fingerprint corresponds to the fingerprint in v2 and v3 network status
documents as specified in /doc/spec/dir-spec.txt in the Tor sources.
"Published" SP YYYY-MM-DD SP HH:MM:SS NL
The publication time, in UTC, of the most recent relay descriptor that
was known when the test was initiated. No further test is initiated
until the relay publishes a new descriptor.
"LastStatus" SP YYYY-MM-DD SP HH:MM:SS NL
The last time, in UTC, when the relay was seen in a v2 network status
document. A relay is discarded from the list if it was not seen in a
network status for at least 48 hours.
"ExitAddress" SP address SP YYYY-MM-DD SP HH:MM:SS NL
One or more test results for this relay consisting of the found exit
address and the time, in UTC, when the test was performed. A test is
discarded from the list if it is older than 48 hours.