nihilist/tor
1
0
Fork 0
mirror of https://gitlab.torproject.org/tpo/core/tor.git synced 2024-11-24 04:13:28 +01:00
Code Issues Packages Projects Releases Wiki Activity

Update the documentation in tor_api.h

Browse Source
This commit is contained in:
Nick Mathewson 2018-03-13 10:00:41 +01:00
parent ccf0f77da1
commit e9dbd6dd8f
1 changed files with 5 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
src/or/tor_api.h
View File

@ -66,14 +66,12 @@ void tor_main_configuration_free(tor_main_configuration_t *cfg);
* This function will not return until Tor is done running. It returns zero
* on success, and nonzero on failure.
*
* BUG 23848: In many cases, tor_main will call exit() or abort() instead of
* returning. This is not the intended long-term behavior; we are trying to
* fix it.
* If you want to control when Tor exits, make sure to configure a control
* socket. The OwningControllerFD option may be helpful there.
*
* BUG 23847: You can only call tor_main() once in a single process; if it
* returns and you call it again, you may crash, or you may encounter other
* unexpected behavior, including possible security issues. This is not
* intended long-term behavior; we are trying to fix it.
* BUG 23847: Sometimes, if you call tor_main a second time (after it has
* returned), Tor may crash or behave strangely. We have fixed all issues of
* this type that we could find, but more may remain.
*
* LIMITATION: You cannot run more than one instance of Tor in the same
* process at the same time. Concurrent calls will cause undefined behavior.