Skip to content
scanner for detecting partitions on the tor network
Python
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin
helpers
orscanner
test
.gitignore
LICENSE
README.rst
requirements.txt
setup.py

README.rst

tor network partition/clique scanner

This project has the singular goal of scanning the Tor network for partitions. However this code originated from bwscanner which can be found here: https://github.com/TheTorProject/bwscanner

(the original git history is not preserved in this repository)

scan method

It's simple. Make two hop Tor circuits, for each circuit build we record:

  • success
  • fail
  • timeout
  • time duration to failure
  • time duration to success

Care is taken to not make rapid sequential Tor circuit builds through the same relays. Said another way: we use the Fisher Yates shuffle algorithm to shuffle our circuit permutations.

special features

  • partition scheme Fisher Yates shuffling alogirthm allowing the scanner to run on multiple processes or machines so that different slices of circuit permutations can be scanned in parallel
  • uses relays from consensus file or a text file containing relay fingerprints
  • can optionally test circuits specified in a text file... and can optionally reverse circuit polarity
  • resume feature NOT YET FINISHED: https://github.com/david415/tor_partition_scanner/issues/1

contributors

Special thanks to the following excellent humans who have contributed code:

license

GPL3 - see LICENSE file for details

You can’t perform that action at this time.