embedded

Overview ¶

Package embedded implements process interfaces for statically linked, embedded Tor. Note, processes created here are not killed when a context is done like w/ os.Exec.

Usage ¶

This package can be used with CGO to statically compile Tor. This package expects https://github.com/cretz/tor-static to be cloned at $GOPATH/src/github.com/cretz/tor-static as if it was fetched with go get. If you use go modules the expected path would be $GOPATH/pkg/mod/github.com/cretz/tor-static To build the needed static libs, follow the README in that project. Once the static libs are built, this uses CGO to statically link them here. For Windows this means something like http://www.msys2.org/ needs to be installed with gcc.exe on the PATH (i.e. the same gcc that was used to build the static Tor lib).

The default in here is currently for Tor 0.3.5.x which uses the tor-0.3.5 subdirectory. A different subdirectory can be used for a different version. Note that the current version does support process.Process.EmbeddedControlConn() on non-Windows.