[tor-bugs] #26110 [Core Tor/Tor]: CIRC_BW fields vague

Tor Bug Tracker & Wiki blackhole at torproject.org
Wed May 16 16:06:33 UTC 2018


#26110: CIRC_BW fields vague
--------------------------+------------------------------------
 Reporter:  atagar        |          Owner:  (none)
     Type:  defect        |         Status:  needs_revision
 Priority:  Low           |      Milestone:  Tor: 0.3.4.x-final
Component:  Core Tor/Tor  |        Version:
 Severity:  Minor         |     Resolution:
 Keywords:  spec          |  Actual Points:
Parent ID:                |         Points:
 Reviewer:  mikeperry     |        Sponsor:
--------------------------+------------------------------------
Changes (by mikeperry):

 * status:  needs_review => needs_revision


Comment:

 There's a couple things that are not quite right here, as a consequence of
 what I needed from these fields:
 {{{
 Circuit data falls into two categories: delivered payloads and overhead.
 }}}

 Technically, there are two high level categories: "validated by Tor, and
 unvalidated by Tor." Data that is not checked for correctness or fails a
 check for correctness is not counted as valid delivered bytes *or*
 overhead. Of that data that is checked for correctness and is correct, it
 falls into delivered payloads and overhead, and is counted in those
 fields.

 {{{
 +  The sum of DeliveredBytesRead and OverheadBytesRead SHOULD match
 BytesRead,
 +  and same for their written counterparts.
 }}}

 As a result of the first issue, the closest thing we can say here is:

 {{{
 +  The sum of DeliveredBytesRead and OverheadBytesRead MUST be less than
 or equal to BytesRead,
 +  and same for their written counterparts. This sum represents the total
 validated bytes sent
 +  on the circuit.
 }}}

 I am not sure how we want to explain the hierarchy of valid/invalid and
 delivered/overhead. It seems a little tricky.

--
Ticket URL: <https://trac.torproject.org/projects/tor/ticket/26110#comment:6>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online


More information about the tor-bugs mailing list