[tor-bugs] #26376 [Core Tor/Tor]: add cross compiling docs

[Tor Bug Tracker & Wiki]

#26376: add cross compiling docs
--------------------------+------------------------------------
 Reporter:  Hello71       |          Owner:  Hello71
     Type:  enhancement   |         Status:  needs_revision
 Priority:  Medium        |      Milestone:  Tor: 0.3.5.x-final
Component:  Core Tor/Tor  |        Version:  Tor: unspecified
 Severity:  Normal        |     Resolution:
 Keywords:                |  Actual Points:
Parent ID:                |         Points:
 Reviewer:  teor          |        Sponsor:  Sponsor8-can
--------------------------+------------------------------------

Comment (by Hello71):

 Replying to [comment:11 teor]:
 > This documentation seems ok to me.
 >
 > But I am not sure that the references to compiling on Windows are
 accurate:
 >
 > > Compiling tor *on* Windows using mingw is theoretically supported, but
 few
 > > developers actually use this configuration, and it is not used to
 build Tor
 > > Browser. Therefore, this guide will only cover cross-compilation.
 >
 > We compile tor on Windows using MSYS2 on every pull request on 0.3.4 and
 later:
 > https://ci.appveyor.com/project/torproject/tor

 Didn't exist when I wrote this :)


 > MSYS2 contains cygwin as well as mingw. The library and compiler names
 suggest that our builds just use mingw. But I haven't checked if the
 builds or binaries depend on cygwin.

 I'm virtually certain that they don't.

 > > 2. Acquire libevent, openssl, and zlib cross-compiled for mingw. ...
 >
 > MSYS2 has package repositories containing these libraries. There seem to
 be versions of the libraries that just depend on mingw.

 Should be, I forgot about MSYS2. Also I'm not sure if their packages are
 usable for cross-compiling.

 > Once this cross-compiling document is accurate, we should merge it.
 > Then we can open tickets for mingw-on-Windows and MXE builds.

 Sounds good.

 Replying to [comment:12 teor]:
 > It might also be worth mentioning that you can cross-compile tor for
 Windows on Windows 10 using Windows Subsystem for Linux, which is an
 emulated Linux environment.

 I think that was a worse option when I wrote this, but sure.

 Replying to [comment:13 teor]:
 > I don't understand why we get cross-compiled libraries from Jenkins,
 when we can just get signed libraries from Debian.

 For non-Debian users.

 > I also think that ahf's instructions are much easier to follow.
 >
 > Is there a reason you rewrote/summarised them?
 >
 > https://github.com/ahf/tor-win32/

 I didn't know ahf had instructions.

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