96 Commits

Author SHA1 Message Date
Dimitris Apostolou
29245fd50d Fix typos and cleanup 2021-10-25 16:35:13 -04:00
Oleh Franchuk
517fcea195 bandwidth-file-spec: Add 'Table of contents' 2021-09-22 14:42:40 +03:00
Georg Koppen
e6b05bf448 Clarify Torflow's aggregation steps
Closes torspec#40.
2021-03-22 10:37:51 +00:00
juga0
85e94b9c54 bandwidth-file: Remove KeyValue recent_measurement_attempt_count
because of sbws#40020 and potentially sbws#40023.

Closes: #34.
2020-12-17 09:50:46 +00:00
juga0
1bb454e7e5 bandwidth-file: Tor version was added in v1.4.0
bandwidth file version, not v1.5.0.

Closes: #35
2020-12-07 11:17:58 +00:00
Georg Koppen
47b495f5f0
Bug 33759: Fix recent_measurements_excluded_few_count key 2020-03-30 13:32:56 +00:00
Nick Mathewson
2896446cea Merge remote-tracking branch 'tor-github/pr/113' 2020-03-12 12:48:12 -04:00
juga0
1621056cf7 bandwidth-file: Replace Add by Adds 2020-03-05 14:27:52 +00:00
juga0
9cf0d3fbcb bandwidth-file: Remove specification version 1.3.0.
since there was never a bandwidth file published by bwauths using that
nor sbws ever generated that version because it was forgotten to
increment it when adding country related KeyValues.
2020-03-05 14:27:52 +00:00
juga0
7b12eb7cee bandwidth-file: Add forgotten KeyValues
Some bandwidth related KeyValues were added to the version 1.2.0,
but they were forgotten when writing this specification.
The same happened with some monitoring KeyValues in the version 1.4.0.
They have not been added to the examples, since they don't contain all
the KeyValues.

Closes #30726.
2020-03-05 14:27:52 +00:00
juga0
4ec93f2d8b bandwidth-file: Correct KeyValues names
The KeyValues never appeared in a bandwidth file generated by the
bwauths with those names, it was a mistake when writing this
specification.

The replacements done are:

- s/desc_bw_average/desc_bw_avg/
- s/desc_obs_bw_last/desc_bw_obs_last/
- s/desc_obs_bw_mean/desc_bw_obs_mean/

And in the examples:

- s/desc_avg_bw/desc_bw_avg/
- s/desc_obs_bw_last/desc_bw_obs_last/
- s/desc_obs_bw_mean/desc_bw_obs_mean/

Part of #30726.
2020-03-03 14:58:04 +00:00
juga0
7d8b4bcffb bandwidth-file: Add tor_version header
Part of #30196.
2020-02-09 18:52:43 +00:00
Hans-Christoph Steiner
a3fd193023 fix erroneous header numbering punctuation
The clear standard is trailing "." after each numeric section.  This fixes
the small handful of outliers.  This makes it easy to convert these headers
to common markup formats, for example:
http://hyperpolyglot.org/lightweight-markup
2019-11-26 21:03:19 +01:00
Hans-Christoph Steiner
c15cc8a5a8 standardize whitespace in the titles
This is one small step towards making these a standard, parsable format.
2019-11-26 20:29:12 +01:00
Nick Mathewson
1b05c7c9ed Merge remote-tracking branch 'tor-github/pr/82' 2019-05-14 11:40:56 -04:00
juga0
cfe12e6a0e bandwidth-file: Add HeaderLine non-terminal
To make more clear that header lines do not contain spaces and simplify
parsers.
This does not change the format.

Closes: #30311
2019-05-13 13:41:22 -04:00
juga0
57c85e3e3a bandwidth-file: Replace KeyWord by Key
in the nonterminals definition, so that it match implementations
and does not fail with a grammar parser.

Closes: #30373
2019-05-12 09:20:46 +00:00
teor
62107ebd91
bandwidth-file: Add time to report half network header KeyValue 2019-03-30 13:50:49 +10:00
teor
838e1a52d0
bandwidth-file: Add relay line diagnostic KeyValues
Make Tor directory authorities avoid voting on relay bandwidths
for relays that were not successfully measured. But report diagnostics
for those relays in the Bandwidth File.

When there are not enough eligible relays, put all the relays in the file
for diagnostic purposes. But mark them so that Tor avoids voting on their
bandwidths.

Closes 29813, 29853.
2019-03-30 13:50:45 +10:00
teor
41a5206053
bandwidth-file: Add summaries for format version 1.3.0 and 1.4.0
Part of 29754.
2019-03-30 13:50:42 +10:00
teor
df8c732cbe
bandwidth-file: Add new RelayLine monitoring KeyValues
Part of 29754.
2019-03-30 13:50:35 +10:00
teor
d62535565c
bandwidth-file: Remove SP from the end of KeyValues
The final KeyValue isn't followed by SP.

The spaces are added between KeyValues when the RelayLine is formatted.
2019-03-29 17:06:23 +10:00
teor
eeab56c313
bandwidth-file: Fix missing cardinalities, format versions, and headings
Also fix some typos.
2019-03-29 17:06:20 +10:00
juga0
9d416247be
bandwidth-file: Add version 1.4.0 examples
of header and lines generated by sbws.

Closes #29754
2019-03-29 17:06:17 +10:00
juga0
2929fcb8ff
bandwidth-file: Add header KeyValues to monitor relays
Part of #29754.
2019-03-29 17:06:13 +10:00
juga0
a672a21d16 bandwidth-file: Replace mistaken NL by SP
in some of the Bandwidth Line KeyValues.

Closes #29814.
2019-03-19 10:18:21 +00:00
Nick Mathewson
7139f7a7d1 Merge remote-tracking branch 'tor-github/pr/59' 2019-03-11 09:44:00 -04:00
teor
8d7d1a7ea1 bandwidth-file: Clean up trailing spaces in the text file 2019-03-08 10:29:14 -05:00
teor
b8ca52cc89 bandwidth-file: Correct part of the version 1.2.0 change description 2019-03-08 10:29:14 -05:00
Damian Johnson
f67315832d Consistently use term 'Bandwidth File'
Usually the 'Bandwidth File' spec called its actual documents 'Bandwidth
Lists'. Juga and teor have both said they prefer the term 'Bandwidth File'.
Standardizing this so we have a consistent name for these documents...

  https://trac.torproject.org/projects/tor/ticket/28615#comment:9
2019-03-08 10:29:14 -05:00
juga0
5a5571e7d2 fixup! bandwidth-file: Add scanner and destination country 2019-03-06 06:35:14 +00:00
juga0
63779daf02 bandwidth-file: Add scanner and destination country
Closes: #29354
2019-03-01 10:47:47 +00:00
teor
f572865b37
bandwidth-file: Fix a typo, the file is not a fallback file
Fixes bug 29578.
2019-02-25 20:15:59 +10:00
juga0
5134ea0f83 bandwidth-file: remove measured word from bw
since the "bw" value might be scaled.
2019-02-04 17:49:43 +00:00
juga0
50f43f7521 bandwidth-file: add units to the bandwidth values. 2019-02-04 17:48:16 +00:00
teor
63676e7c2f
bandwidth: typos and spacing 2019-01-23 08:23:13 +10:00
teor
7f573b3c59
bandwidth: Prefer a 5-character header terminator 2019-01-23 08:17:20 +10:00
teor
9a3f014c82
Spacing 2019-01-22 10:17:30 +10:00
teor
b03483635d
Allow parsers to fail files with duplicate relay lines 2019-01-22 10:15:34 +10:00
teor
49a0f5cfb6
Remove sbws version from relay line key value list
The version was out of date, and we're not tracking the versions when keys were added.
2019-01-22 10:12:01 +10:00
teor
733cfbdb5a
Clarify relay line and key value orders 2019-01-22 10:03:08 +10:00
teor
9b206eda05
Clarify header and relay line order 2019-01-22 09:55:00 +10:00
teor
cbb2c760b3
bandwidth: use consistent 2 space indents, and reflow long lines 2019-01-14 11:38:47 +10:00
teor
d340731878
bandwidth: minor rewording and spacing 2019-01-14 11:29:31 +10:00
teor
5ddeda35ae
bandwidth: reword Header/Header Lines/Relay Lines descriptions 2019-01-14 11:28:45 +10:00
teor
aa8807d306
bandwidth: Add sbws and Tor versions where required 2019-01-14 11:27:38 +10:00
teor
469698c3ec
bandwidth: rewrite the intro
Part of 27079.
2019-01-14 11:21:14 +10:00
Nick Mathewson
78fdde420a Merge remote-tracking branch 'tor-github/pr/37' 2018-11-26 16:52:40 -05:00
juga0
a5292eefbd Correct spaces format 2018-11-08 08:09:52 +00:00
juga0
36837f8a85 Correct header keyvalue names in examples
And reorder them in the way sbws does.
2018-11-08 08:01:31 +00:00