wiki:AdminDepLibs

Version 6 (modified by Kevin Reed, 6 years ago) (diff)

Updated OpenSSL build instructions provided by Al Seippel

BOINC Dependencies on Windows

BOINC uses a number of third party libraries to handle things like communicating through proxies and SSL support. Building these libraries with support for debugging can be tricky.

A number of dependency trees have been created for Visual Studio:

2005: boinc_depends_win_vs2005
2008: boinc_depends_win_vs2008
2010: boinc_depends_win_vs2010
2013: boinc_depends_win_vs2013

These will need to be updated whenever new third party libraries need to be used or the Microsoft C-Runtime library has been updated.

Building Updated Dependency Libraries

As of VS 2013 our libraries should be configured with the following settings for all builds.

Compiler Settings:

  • Debug Information Format: Program Database (/Zi)
  • Runtime Library: Multi-threaded DLL (/MD)

Linker Settings:

  • Generated Debug Info: Yes (/DEBUG)
  • Set Checksum: Yes (/RELEASE)

These settings enable the use of the correct C-Runtime library for BOINC and the ability for a debugger to correctly load the right symbol file for a given executable or DLL from BOINC's symbol store.

BOINC builds with four configurations:

  • Debug/x86
  • Release/x86
  • Debug/x64
  • Release/x64

Each library will need to have an updated binary and symbol file for each configuration.

zLib

Project URL: http://www.zlib.net/

zLib keeps its Visual Studio project files under 'contrib/vstudio/vc11'. Upgrade the project files to VS 2013.

Build all four configurations and copy the dll, lib, and pdb file to the root of the zlib source directory so that libcurl can find it later.

Project file diffs: zLib?

OpenSSL

Project URL: https://www.openssl.org/ Follow these build instructions:

1) Install perl from https://www.activestate.com/activeperl

2) Open Visual Studio Command Prompt

3) Build 32-bit Release and debug. Roughly based on INSTALL.W32 from the main openssl directory:

Release:

$ perl Configure VC-WIN32 no-asm --prefix=c:\openssl_W32_Release 
$ ms\do_ms 
$ nmake -f ms\ntdll.mak 
$ nmake -f ms\ntdll.mak test 
$ nmake -f ms\ntdll.mak install

Debug:

$ perl Configure VC-WIN32 no-asm --prefix=c:\openssl_W32_Debug 
$ ms\do_ms 
$ nmake -f ms\ntdll.mak 
$ nmake -f ms\ntdll.mak test 
$ nmake -f ms\ntdll.mak install

4) Open Visual Studio x64 Win64 Command Prompt (note this is different than the normal visual studio command prompt):

5) Build 64-bit Release and debug. Instructions in INSTALL.W64 are not complete/detailed:

Release:

$ perl Configure VC-WIN64A --prefix=c:\openssl_W64_Release 
$ ms\do_win64a 
$ nmake -f ms\ntdll.mak 
$ nmake -f ms\ntdll.mak test 
$ nmake -f ms\ntdll.mak install

Debug:

$ perl Configure debug-VC-WIN64A --prefix=c:\openssl_W64_Debug 
$ ms\do_win64a 
$ nmake -f ms\ntdll.mak 
$ nmake -f ms\ntdll.mak test 
$ nmake -f ms\ntdll.mak install

6) Copy resulting files to the appropriate boinc_dependencies directories

Curl

Project URL: http://curl.haxx.se/libcurl/

Follow build instructions in docs/INSTALL for all configurations.

Example (Release/x86):

     set ZLIB_PATH=c:\src\sdks\zlib-1.2.8
     set OPENSSL_PATH=c:\src\sdks\openssl-1.0.2a
     nmake -f Makefile cfg=release-dll-ssl-dll-zlib-dll

Project file diffs: Curl

Sqlite

(will be deprecated once we switch to concierge-based auto attach)

Project URL: https://www.sqlite.org/

Use the project file included in the Sqlite project file diff page.

Project file diffs: Sqlite

WxWidgets

URL: http://www.wxwidgets.org/