[tor-commits] [torspec/master] Add new header KeyValues

[nickm at torproject.org]

commit a955a35f05cb37bd152e9ab59ff2d93af43b2eba
Author: juga0 <juga at riseup.net>
Date:   Fri Oct 26 12:52:23 2018 +0000

    Add new header KeyValues
---
 bandwidth-file-spec.txt | 60 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 60 insertions(+)

diff --git a/bandwidth-file-spec.txt b/bandwidth-file-spec.txt
index 9a3f63f..cfa2ab9 100644
--- a/bandwidth-file-spec.txt
+++ b/bandwidth-file-spec.txt
@@ -208,6 +208,66 @@ It consists of:
 
     This Line has been added in version 1.1.0 of this specification.
 
+  "percent_eligible_relays=" Int NL
+
+    [Zero or one time.]
+
+    The minimum percentage of eligible measured relays with respect
+    to the number of relays in the consensus to include in this file.
+
+    Implementations SHOULD include this KeyValue when
+    "minimum_percent_eligible_relays" is minor than
+    "percent_eligible_relays" and MAY not include any RelayLine.
+
+    This Line has been added in version 1.2.0 of this specification.
+
+  "minimum_number_eligible_relays=" Int NL
+
+    [Zero or one time.]
+
+    The minimum number of relays to include in the bandwidth file.
+
+    Implementations SHOULD include this KeyValue when
+    "minimum_percent_eligible_relays" is minor than
+    "percent_eligible_relays" and MAY not include any RelayLine.
+
+    This Line has been added in version 1.2.0 of this specification.
+
+  "number_consensus_relays=" Int NL
+
+    [Zero or one time.]
+
+    The number of relays in the consensus.
+
+    Implementations SHOULD include this KeyValue when
+    "minimum_percent_eligible_relays" is minor than
+    "percent_eligible_relays" and MAY not include any RelayLine.
+
+    This Line has been added in version 1.2.0 of this specification.
+
+  "number_eligible_relays=" Int NL
+
+    [Zero or one time.]
+
+    The number of relays that has been measured and are eligible to
+    include in the bandwidth file.
+
+    Implementations SHOULD include this KeyValue when
+    "minimum_percent_eligible_relays" is minor than
+    "percent_eligible_relays" and MAY not include any RelayLine.
+
+    This Line has been added in version 1.2.0 of this specification.
+
+  "minimum_percent_eligible_relays=" Int NL
+
+    [Zero or one time.]
+
+    Implementations SHOULD include this KeyValue when
+    "minimum_percent_eligible_relays" is minor than
+    "percent_eligible_relays" and MAY not include any RelayLine.
+
+    This Line has been added in version 1.2.0 of this specification.
+
   KeyValue NL
 
     [Zero or more times.]