[tor-commits] [torspec/master] Bug 30173+29203: Document reduced+disabled padding consensus params

[nickm at torproject.org]

commit a1935efba2dcaa1888d85284a26e47ed20e3f4e0
Author: Mike Perry <mikeperry-git at torproject.org>
Date:   Thu Apr 18 19:27:31 2019 +0000

    Bug 30173+29203: Document reduced+disabled padding consensus params
---
 proposals/254-padding-negotiation.txt | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/proposals/254-padding-negotiation.txt b/proposals/254-padding-negotiation.txt
index 087f060..0d14c09 100644
--- a/proposals/254-padding-negotiation.txt
+++ b/proposals/254-padding-negotiation.txt
@@ -367,6 +367,17 @@ When either global or machine limits are reached, padding is no longer
 scheduled. The machine simply becomes idle until the overhead drops below
 the threshold.
 
+Finally, the consensus can also be used to specify that clients should
+use only machines that are flagged as reduced padding, or disable circuit
+padding entirely, with the following two parameters:
+
+   * circpad_padding_reduced=1
+     - Tells clients to only use padding machines with the
+       'reduced_padding_ok' machine condition flag set.
+   * circpad_padding_disabled=1
+     - Tells clients to stop circuit padding immediately, and not negotiate
+       any further padding machines.
+
 5.2. Overhead accounting
 
 In order to monitor the quantity of padding to decide if we should alter