aboutsummaryrefslogtreecommitdiff
path: root/spec/padding-spec/connection-level-padding.md
diff options
context:
space:
mode:
authorNick Mathewson <nickm@torproject.org>2023-10-13 18:00:42 -0400
committerNick Mathewson <nickm@torproject.org>2023-10-13 18:00:42 -0400
commitf79272ef1f774b3788b74a3fe4fef75095dfae06 (patch)
tree8f47bebaa06c444f632bf8c4afbd793c4972a27d /spec/padding-spec/connection-level-padding.md
parentfa014ec90411fd754dd257d04afa1a953e15bf31 (diff)
downloadtorspec-f79272ef1f774b3788b74a3fe4fef75095dfae06.tar.gz
torspec-f79272ef1f774b3788b74a3fe4fef75095dfae06.zip
Run markdownlint --fix on spec.
Diffstat (limited to 'spec/padding-spec/connection-level-padding.md')
-rw-r--r--spec/padding-spec/connection-level-padding.md8
1 files changed, 7 insertions, 1 deletions
diff --git a/spec/padding-spec/connection-level-padding.md b/spec/padding-spec/connection-level-padding.md
index 3bb7f12..b0450d7 100644
--- a/spec/padding-spec/connection-level-padding.md
+++ b/spec/padding-spec/connection-level-padding.md
@@ -1,7 +1,9 @@
<a id="padding-spec.txt-2"></a>
+
# Connection-level padding
<a id="padding-spec.txt-2.1"></a>
+
## Background
Tor clients and relays make use of CELL_PADDING to reduce the resolution of
@@ -87,6 +89,7 @@ measurement is unidirectional, and so traffic must be sent by both parties
in order to prevent record splitting.
<a id="padding-spec.txt-2.2"></a>
+
## Implementation
Tor clients currently maintain one TLS connection to their Guard node to
@@ -129,6 +132,7 @@ queue that they practically can, and if this queue is already nonempty,
padding should not be scheduled until after the queue does become empty.)
<a id="padding-spec.txt-2.3"></a>
+
## Padding Cell Timeout Distribution Statistics
To limit the amount of padding sent, instead of sampling each endpoint
@@ -160,6 +164,7 @@ values for each random variable:
```
<a id="padding-spec.txt-2.4"></a>
+
## Maximum overhead bounds
With the default parameters and the above distribution, we expect a
@@ -178,6 +183,7 @@ roughly the current amount of Tor directory traffic[11]. Of course, our
idle, so we expect the actual overhead to be much lower than this.
<a id="padding-spec.txt-2.5"></a>
+
## Reducing or Disabling Padding via Negotiation
To allow mobile clients to either disable or reduce their padding overhead,
@@ -222,6 +228,7 @@ Clients and bridges MUST reject padding negotiation messages from relays,
and close the channel if they receive one.
<a id="padding-spec.txt-2.6"></a>
+
## Consensus Parameters Governing Behavior
Connection-level padding is controlled by the following consensus parameters:
@@ -280,4 +287,3 @@ Connection-level padding is controlled by the following consensus parameters:
open.
- Default: 3600
```
-