README.rst 2.46 KB
Newer Older
juga's avatar
juga committed
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
Readme
======

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

The scanner measures the bandwidth of each relay in the Tor network
(except the directory authorities) by creating a two hops circuit with
the relay. It then measures the bandwidth by downloading data from a
destination Web Server and stores the measurements.

The generator read the measurements, aggregates, filters and scales them
using torflow’s scaling method. Then it generates a bandwidth list file
that is read by a directory authority to report relays’ bandwidth in its
vote.

**WARNING**: This software is intended to be run by researchers using a
test Tor network, such as chutney or shadow, or by the Tor bandwidth
authorities on the public Tor network. Please do not run this software
on the public Tor network unless you are one of the Tor bandwidth
authorities, to avoid creating unnecessary traffic.

23
24
25
26
**ADVICE**: It is recommended to read this documentation at
https://tpo.pages.torproject.net/network-health/sbws.
At https://gitlab.torproject.org/tpo/network-health/sbws
some links won’t be properly rendered. It can also be read after
juga's avatar
juga committed
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
installing the Debian package ``sbws-doc`` in ``/usr/share/doc/sbws`` or
after building it locally as explained in
``./docs/source/documenting.rst``.

Installing
----------

See `./INSTALL.rst <INSTALL.rst>`__ (in local directory or tpo Gitlab)
or `INSTALL.html <INSTALL.html>`__ (local build or Read the Docs).

Deploying and running
---------------------

See `./DEPLOY.rst <DEPLOY.rst>`__ (in local directory or tpo Gitlab) or
`DEPLOY.html <DEPLOY.html>`__ (local build or Read the Docs).

Changelog
---------

See `./CHANGELOG.rst <CHANGELOG.rst>`__ (in local directory or tpo
Gitlab) or `CHANGELOG.html <CHANGELOG.html>`__ (local build or Read the
Docs).

Documentation
-------------

More extensive documentation can be found in the ``./docs`` directory,
54
and online at https://tpo.pages.torproject.net/network-health/sbws.
juga's avatar
juga committed
55
56
57
58
59
60
61
62
63
64

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 <https://creativecommons.org/publicdomain/zero/1.0>`__.

You can find a copy of the CC0 Public Domain Dedication along with this
juga's avatar
juga committed
65
software in ./LICENSE.rst
juga's avatar
juga committed
66
67
68
69

Authors
-------

Georg Koppen's avatar
Georg Koppen committed
70
See `./AUTHORS.rst <AUTHORS.rst>`__ (in local directory or tpo Gitlab) or
juga's avatar
juga committed
71
`AUTHORS.html <AUTHORS.html>`__ (local build or Read the Docs).