aboutsummaryrefslogtreecommitdiff
path: root/spec/dir-spec/serving-bandwidth-list-files.md
diff options
context:
space:
mode:
Diffstat (limited to 'spec/dir-spec/serving-bandwidth-list-files.md')
-rw-r--r--spec/dir-spec/serving-bandwidth-list-files.md18
1 files changed, 16 insertions, 2 deletions
diff --git a/spec/dir-spec/serving-bandwidth-list-files.md b/spec/dir-spec/serving-bandwidth-list-files.md
index 531dc2b..1263e43 100644
--- a/spec/dir-spec/serving-bandwidth-list-files.md
+++ b/spec/dir-spec/serving-bandwidth-list-files.md
@@ -1,4 +1,5 @@
<a id="dir-spec.txt-3.4.3"></a>
+
### Serving bandwidth list files
If an authority has used a bandwidth list file to generate a vote
@@ -27,11 +28,13 @@ The standard URLs for bandwidth list files first-appeared in
Tor 0.4.0.4-alpha.
<a id="dir-spec.txt-3.5"></a>
+
## Downloading missing certificates from other directory authorities
XXX when to download certificates.
<a id="dir-spec.txt-3.6"></a>
+
## Downloading server descriptors from other directory authorities
Periodically (currently, every 10 seconds), directory authorities check
@@ -67,6 +70,7 @@ Authorities SHOULD NOT download descriptors for routers that they would
immediately reject for reasons listed in section 3.2.
<a id="dir-spec.txt-3.7"></a>
+
## Downloading extra-info documents from other directory authorities
Periodically, an authority checks whether it is missing any extra-info
@@ -77,6 +81,7 @@ documents are missing. We follow the same splitting and back-off rules
as in section 3.6.
<a id="dir-spec.txt-3.8"></a>
+
## Computing a consensus from a set of votes
Given a set of votes, authorities compute the contents of the consensus.
@@ -310,7 +315,8 @@ All ties in computing medians are broken in favor of the smaller or
earlier item.
<a id="dir-spec.txt-3.8.0.1"></a>
-#### Deciding which Ids to include.
+
+#### Deciding which Ids to include
This sorting algorithm is used for consensus-method 22 and later.
@@ -336,6 +342,7 @@ This sorting algorithm is used for consensus-method 22 and later.
```
<a id="dir-spec.txt-3.8.0.2"></a>
+
#### Deciding which descriptors to include
Deciding which descriptors to include.
@@ -354,6 +361,7 @@ that matches the largest set, breaking ties in favor of the most recently
published, and then in favor of the smaller server descriptor digest.
<a id="dir-spec.txt-3.8.1"></a>
+
### Forward compatibility
Future versions of Tor will need to include new information in the
@@ -428,6 +436,7 @@ NOT advertise support for them:
"21" -- Did not correctly enable support for ed25519 key collation.
<a id="dir-spec.txt-3.8.2"></a>
+
### Encoding port lists
Whether the summary shows the list of accepted ports or the list of
@@ -449,6 +458,7 @@ use an accept-style summary and list as much of the port list as is
possible within these 1000 bytes. [XXXX be more specific.]
<a id="dir-spec.txt-3.8.3"></a>
+
### Computing Bandwidth Weights
Let weight_scale = 10000, or the value of the "bwweightscale" parameter.
@@ -631,6 +641,7 @@ Handle bridges and strange exit policies:
Wgm=Wgg, Wem=Wee, Weg=Wed
<a id="dir-spec.txt-3.9"></a>
+
## Computing consensus flavors
Consensus flavors are variants of the consensus that clients can choose
@@ -672,6 +683,7 @@ is a string consisting of alphanumeric characters and dashes:
"network-status-version" SP version [SP flavor] NL
<a id="dir-spec.txt-3.9.1"></a>
+
### ns consensus
The ns consensus flavor is equivalent to the unflavored consensus.
@@ -681,6 +693,7 @@ state that the flavor is "ns" when generating consensuses, but should
accept consensuses where the flavor is omitted.
<a id="dir-spec.txt-3.9.2"></a>
+
### Microdescriptor consensus
The microdescriptor consensus is a consensus flavor that contains
@@ -752,6 +765,7 @@ Additionally, a microdescriptor consensus SHOULD use the sha256 digest
algorithm for its signatures.
<a id="dir-spec.txt-3.10"></a>
+
## Exchanging detached signatures
Once an authority has computed and signed a consensus network status, it
@@ -829,6 +843,7 @@ and only copied it from the proposals. Review carefully. -KL]
consensus document.]
<a id="dir-spec.txt-3.11"></a>
+
## Publishing the signed consensus
The voting period ends at the valid-after time. If the consensus has
@@ -867,4 +882,3 @@ locations
```
The standard URLs for bandwidth list files first-appeared in Tor 0.3.5.
-