[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:  (none)
         Type:  defect        |     Status:  new
     Priority:  Medium        |  Milestone:  Tor: 0.3.4.x-final
    Component:  Core Tor/Tor  |    Version:
     Severity:  Normal        |   Keywords:  tor-mobile, s8-api
Actual Points:                |  Parent ID:  #23684
       Points:                |   Reviewer:
      Sponsor:                |
------------------------------+--------------------------------
 It would be good to have an interface something like this for controller
 authors to use, if they're embedding Tor:
 {{{
 #ifdef _WIN32
 #define CONTROL_SOCKET SOCKET
 #else
 #define CONTROL_SOCKET int
 #endif

 /**
  * Tells Tor to create a socket for an owning controller connection to the
  * Tor that will be launched.  Return the socket.
  */
 CONTROL_SOCKET tor_main_configuration_setup_control_socket(
                                            tor_main_configuration_t *cfg);

 #idef _WIN32
 /** Windows-only; experimental. Tells Tor to create an anonymous pipe
  * (whatever that's called) as an owning connection for the he controller,
 and
  * and return that pipe. */
 HANDLE tor_main_configuration_setup_control_pipe(
                                            tor_main_configuration_t *cfg);
 #endif

 }}}

 We should make sure it's portable, and that it can be implemented both
 with libtor_runner and with in-process Tor.

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