Readme

Simple Bandwidth Scanner (called sbws) is a Tor bandwidth scanner that produces bandwidth measurements files to be used by Directory Authorities.

The scanner builds two hop circuits consisting of the relay being measured and a fast exit. Over these circuits it measures RTT and bandwidth.

WARNING: This software is only intended to be run by Tor directory authorities or researches using a test Tor network, chutney or shadow. Please, do not run this software otherwise, since the measurements would not be used by Tor and would only create more traffic in the Tor network.

sbws will be considered production ready when version 1.0.0 will be released.

Installing

See ./INSTALL.rst (or INSTALL or INSTALL )

Deploying and running

See ./DEPLOY.rst (or DEPLOY or DEPLOY )

Contributing

See ./CONTRIBUTING.rst (or CONTRIBUTING or CONTRIBUTING )

Changelog

See ./CHANGELOG.rst (or CHANGELOG or CHANGELOG )

Documentation

More extensive documentation can be found in the ./docs directory, and online at sbws.rtfd.io and this onion service (v2).

License

This work is in the public domain within the United States.

We waive copyright and related rights in the work worldwide through the CC0-1.0 license.

You can find a copy of the CC0 Public Domain Dedication along with this software in ./LICENSE.md

Authors

See ./AUTHORS.md (or AUTHORS