[tor-bugs] #24204 [Core Tor/Tor]: Improve the in-process Tor API: create owning control port

[Tor Bug Tracker & Wiki]

#24204: Improve the in-process Tor API: create owning control port
-------------------------------------------------+-------------------------
 Reporter:  nickm                                |          Owner:  nickm
     Type:  defect                               |         Status:
                                                 |  accepted
 Priority:  Very Low                             |      Milestone:  Tor:
                                                 |  unspecified
Component:  Core Tor/Tor                         |        Version:
 Severity:  Normal                               |     Resolution:
 Keywords:  tor-mobile, s8-api,                  |  Actual Points:
  034-triage-20180328, 035-roadmap-subtask       |
Parent ID:  #25510                               |         Points:
 Reviewer:                                       |        Sponsor:
                                                 |  Sponsor8-can
-------------------------------------------------+-------------------------

Comment (by hellais):

 I am now a believe in this solution.

 The main advantages I see for a mobile app developer use-case, is the fact
 that:

 1. You can create out of this an event telling you that the Tor control
 port is ready to receive messages without relying on polling to see if teh
 port is open.

 ex. since the function returns a socket handle, you can just write
 directly to the socket and when you receive a response back you know the
 control port is ready

 2. You can use it to signal tor to shutdown cleanly, by simply closing the
 socket.

 As such this solution crossed out two of the items I listed in
 https://trac.torproject.org/projects/tor/ticket/25510#comment:7, namely:

 - Ability to know when the control port is ready
 - Ability to terminate tor cleanly without using the control port

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