diff options
| author | Nick Mathewson <nickm@torproject.org> | 2017-11-01 13:11:45 -0400 |
|---|---|---|
| committer | Nick Mathewson <nickm@torproject.org> | 2017-11-01 13:22:09 -0400 |
| commit | 8b313bd4adac122bb01c52af3e616c5c69fd9414 (patch) | |
| tree | b584c0a66d0342053a285d7552e821472397b5c7 /src/tools | |
| parent | e8682c85945b3283adb113f29f9fbd7977a052aa (diff) | |
| download | tor-8b313bd4adac122bb01c52af3e616c5c69fd9414.tar.gz tor-8b313bd4adac122bb01c52af3e616c5c69fd9414.zip | |
Explain purpose, usage, and status of tor_runner.c
Diffstat (limited to 'src/tools')
| -rw-r--r-- | src/tools/tor_runner.c | 15 |
1 files changed, 15 insertions, 0 deletions
diff --git a/src/tools/tor_runner.c b/src/tools/tor_runner.c index ee35b72df3..ac398742dc 100644 --- a/src/tools/tor_runner.c +++ b/src/tools/tor_runner.c @@ -4,6 +4,21 @@ * Copyright (c) 2007-2017, The Tor Project, Inc. */ /* See LICENSE for licensing information */ +/** + * @file tor_runner.c + * @brief Experimental module to emulate tor_run_main() API with fork+exec + * + * The functions here are meant to allow the application developer to + * use the tor_run_main() API without having to care whether Tor is + * running in-process or out-of-process. For in-process usage, the + * developer can link Tor as a library and call tor_run_main(); for + * out-of-process usage, the developer can link this library instead. + * + * This interface is EXPERIMENTAL; please let us know if you would like + * to depend on it. We don't know yet whether it will be reliable in + * practice. + */ + #include "tor_api.h" #include "tor_api_internal.h" |