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