[tor-commits] [spec/master] Added reverse traceroute specification

[art at torproject.org]

commit de49e3fab389d484f286e3ea87bc9e35cae62f4e
Author: Iain R. Learmonth <irl at fsfe.org>
Date:   Thu Jan 15 14:57:33 2015 +0000

    Added reverse traceroute specification
---
 test-helpers/th-006-reverse-traceroute.md |   52 +++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)

diff --git a/test-helpers/th-006-reverse-traceroute.md b/test-helpers/th-006-reverse-traceroute.md
new file mode 100644
index 0000000..6a6071d
--- /dev/null
+++ b/test-helpers/th-006-reverse-traceroute.md
@@ -0,0 +1,52 @@
+# Specification version number
+
+2014-12-15-000
+
+# Specification name
+
+Reverse Traceroute Test Helper
+
+# Helper description
+
+The reverse traceroute test helper listens for incoming connections either on
+a TCP socket or via a web server. When a connection is initiated, it performs
+a reverse traceroute to the connection's source IP address and returns the
+results of the traceroute via the same connection.
+
+# Helper preconditions
+
+ * An Internet connection
+ * An Internet-Reachable TCP Port
+ * No known middleboxes rewriting packet payloads in unexpected ways between
+   the helper and the transit ISP
+
+# Expected impact
+
+Through cross-referencing results, the ability to determine where on the
+network path network interference exists which could indicate whether or not
+the interference is localised to an access ISP or being conducted on a national
+level.
+
+# Expected inputs
+
+ * The initiation of a connection.
+
+# Expected output
+
+ * The results of a traceroute giving the IP address of each hop and, if
+   available, the ping times to each hop.
+
+The encoding chosen could be JSON, CSV, or another format. It should be
+possible to convert between this format and the format used by tests that
+perform a forward traceroute in ooni-probe.
+
+# Possible conclusions
+
+Through cross-referencing of results, it should be possible to determine in
+which AS the network interference is occuring.
+
+# Notes
+
+An implementation of this test helper is currently being worked on by Iain R.
+Learmonth <<irl at fsfe.org>> using Scapy.
+