[tor-bugs] #25618 [Core Tor/Tor]: Document ISO_STREAM in the tor man page

[Tor Bug Tracker & Wiki]

#25618: Document ISO_STREAM in the tor man page
--------------------------+----------------------------------
 Reporter:  teor          |          Owner:  (none)
     Type:  defect        |         Status:  new
 Priority:  Medium        |      Milestone:  Tor: unspecified
Component:  Core Tor/Tor  |        Version:
 Severity:  Normal        |     Resolution:
 Keywords:  easy doc      |  Actual Points:
Parent ID:                |         Points:
 Reviewer:                |        Sponsor:
--------------------------+----------------------------------

Comment (by nickm):

 IIUC the default isolation options are:
 {{{
 #define ISO_DEFAULT
 (ISO_CLIENTADDR|ISO_SOCKSAUTH|ISO_SESSIONGRP|ISO_NYM_EPOCH)
 }}}

 So when I do 'git grep ISO_STREAM' I get:
 {{{
 src/or/connection_edge.c:  if ((iso & ISO_STREAM) &&
 src/or/directory.c:    int iso_flags = anonymized_connection ? ISO_STREAM
 : ISO_SESSIONGRP;
 src/or/or.h:   * ISO_STREAM. */
 src/or/or.h:#define ISO_STREAM      (1u<<7)
 }}}

 Only one of these cases actually sets ISO_STREAM, in directory.c:
 {{{
     /* Anonymized tunneled connections can never share a circuit.
      * One-hop directory connections can share circuits with each other
      * but nothing else. */
     int iso_flags = anonymized_connection ? ISO_STREAM : ISO_SESSIONGRP;
 }}}
 but this only happens for directory connections, to ensure that they e.g.
 two service descriptor uploads can't share the same circuit.

 Convinced?  If not, can you remember what made it seem that ISO_STREAM was
 on by default?

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