[tor-commits] [torspec] 04/06: Padding spec: describe behavior with queues.

[gitolite role]

This is an automated email from the git hooks/post-receive script.

nickm pushed a commit to branch main
in repository torspec.

commit 5536d29700d1bcea4b2652a3d7978a197b058a45
Author: Nick Mathewson <nickm at torproject.org>
AuthorDate: Mon May 23 15:07:06 2022 -0400

    Padding spec: describe behavior with queues.
    
    (Briefly: "Sent" is sometimes unobservable, so we should use
    "queued" as a reasonable proxy.)
---
 padding-spec.txt | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/padding-spec.txt b/padding-spec.txt
index 471dd74..262e88f 100644
--- a/padding-spec.txt
+++ b/padding-spec.txt
@@ -180,6 +180,16 @@ Table of Contents
   the event that it is idle in that direction, and will always transmit a
   packet before the minimum 10 second inactive timeout.
 
+  (In practice, an implementation may not be able to determine when,
+  exactly, a cell is sent on a given channel.  For example, even though the
+  cell has been given to the kernel via a call to `send(2)`, the kernel may
+  still be buffering that cell.  In cases such as these, implementations
+  should use a reasonable proxy for the time at which a cell is sent: for
+  example, when the cell is queued.  If this strategy is used,
+  implementations should try to observe the innermost (closest to the wire)
+  queue that the practically can, and if this queue is already nonempty,
+  padding should not be scheduled until after the queue does become empty.)
+
 2.3. Padding Cell Timeout Distribution Statistics
 
   To limit the amount of padding sent, instead of sampling each endpoint

-- 
To stop receiving notification emails like this one, please contact
the administrator of this repository.