1Glossary 2========== 3 4.. glossary:: 5 6 directory authority 7 a special-purpose relay that maintains a list of currently-running 8 relays and periodically publishes a consensus together with the other 9 directory authorities. [#]_ 10 11 bandwidth authority 12 A :term:`directory authority` that runs a :term:`scanner` and a 13 :term:`generator` or obtain :term:`bandwidth list file` s from a 14 :term:`generator`. 15 16 scanner 17 Term to refer to the process that measures the relays' bandwidth. 18 It is also called :term:`generator` when it is the same tool that is 19 used to generate :term:`bandwidth list file` s. 20 21 generator 22 Term to refer to the tool that generates the 23 :term:`bandwidth list file` s. Often used as a synonym for 24 :term:`scanner`. 25 26 bandwidth list file 27 The file generated by :term:`generator` s that is read by the 28 :term:`directory authority` s and included in their votes. 29 See `bandwidth-file-spec.txt <https://gitweb.torproject.org/torspec.git/tree/bandwidth-file-spec.txt>`_ 30 to know about the file specification. 31 32 sbws scanner 33 The ``sbws`` command used to run ``sbws`` as a :term:`scanner`. 34 35 sbws generate 36 The ``sbws`` command used to run ``sbws`` as a :term:`generator`. 37 38 v3bw file 39 The term used by ``sbws`` to refer to :term:`bandwidth list file` 40 v1.1.0. 41 42 .. literalinclude:: v3bw.txt 43 :caption: A v3bw file 44 45 destination 46 The term used by ``sbws`` to refer to a Web server where the 47 :term:`scanner` request files to perform the bandwidth measurements. 48 49.. [#] https://metrics.torproject.org/glossary.html 50