Version 21 (modified by Cas, 8 years ago) (diff)

--

Build libtorrent from source

  1. Ubuntu / Debian
  2. Windows
    1. Debugging libtorrent on Windows
  3. Further Resources

Check libtorrent ​documentation for any updates to build procedures.

Ubuntu / Debian

  1. Install dependencies for libtorrent build automatically using build-dep: 
    sudo apt-get build-dep libtorrent-rasterbar
sudo apt-get install checkinstall

OR if that fails manually install them: 

sudo apt-get install build-essential checkinstall libboost-system-dev libboost-python-dev libssl-dev libgeoip-dev
  1. Download ​libtorrent and extract: 
    tar xf libtorrent-rasterbar.tar.gz
cd libtorrent-rasterbar
  2. Configure: 
    ./configure --enable-python-binding --with-libgeoip --with-libiconv
    • Logging: Add --enable-logging=default to get logs in the current working directory. verbose and error can also be used.
    • Debug: To create a debug build add --enable-debug=yes.
    • VCS: For source code directly from git, run ./autotool.sh to create the configure script (requires autoconf, automake & libtool packages).
  3. Build: 
    make -j$(nproc)
    • CPU Cores: The make option -j$(nproc) will utilize all available cpu cores.
  1. Install library and python bindings: 
    sudo checkinstall
sudo ldconfig
    Substituted make install for checkinstall as it creates a deb package for easier removal/re-install by dpkg.
    Running ldconfig avoids an ImportError for libtorrent-rasterbar.so, a result of Python being unable to find the main library.
  1. Verify libtorrent and the python bindings are installed correctly: 
    python -c "import libtorrent; print libtorrent.version"
>> 1.0.6.0

Windows

  1. Download and install/extract these packages:

Note: Install or extract to a path without spaces e.g. C:\ drive.

  1. Setup the Windows Command Prompt by executing VC for Python vcvarsall.bat, e.g.: 
    "%USERPROFILE%\AppData\Local\Programs\Common\Microsoft\Visual C++ for Python\9.0\vcvarsall.bat"
    Note: If using Visual Studio simple open a Visual Studio 2008 Command Prompt.
  1. Boost Build Steps:

Due to a ​boost bug with VC for Python, need to edit project-config.jam in boost folder to the following: 

using msvc : : : <setup>"%USERPROFILE%\\AppData\\Local\\Programs\\Common\\Microsoft\\Visual C++ for Python\\9.0\\vcvarsall.bat" ;

In the boost directory run the following: 

bootstrap.bat
b2 --with-system --with-date_time --with-python
  1. Create a Boost user-config.jam file in the toplevel folder (e.g. C:\boost) with the following to force msvc version: 
    using msvc : 9.0 : : <setup>"%USERPROFILE%\\AppData\\Local\\Programs\\Common\\Microsoft\\Visual C++ for Python\\9.0\\vcvarsall.bat" ;
    Note: For Visual Studio, simply using msvc : 9.0 ; is required.
  1. libtorrent Build Steps:
    1. Setup the Environmental Variables: 
      set INCLUDE=C:\OpenSSL-Win32\include;%INCLUDE%
set LIB=C:\OpenSSL-Win32\lib;%LIB%
set BOOST_BUILD_PATH=C:\boost
set PATH=%BOOST_BUILD_PATH%;%PATH%
    2. Navigate to libtorrent Python bindings folder: 
      cd C:\libtorrent-rasterbar\bindings\python
    3. Build libtorrent with Python bindings: 
      b2 boost=source link=static geoip=static boost-link=static release optimization=space encryption=openssl

Upon a successful build the library file named libtorrent.pyd is created in the current bindings/python directory.

Debugging libtorrent on Windows

  • Download and install just the debug tools:
  • Build libtorrent with debug enabled by changing release to debug in the b2 build line.
  • Open windbg (C:\Program Files\Debugging Tools for Windows (x86)\windbg.exe):
    • File|Open Executable and tick Debug child processes
    • Hit F5 or Go a few times to get the program running
    • After the crash execute: !analyze -v -f.
  • Symbols for libtorrent will be in the build output path: 
    C:\libtorrent-rasterbar\bindings\python\bin\msvc-9.0\debug\boost-source\geoip-static\link-static\optimization-space\threading-multi
    So the full symbols line should look something like this: 
    srv*;C:\libtorrent-rasterbar\bindings\python\bin\msvc-9.0\debug\boost-source\geoip-static\link-static\optimization-space\threading-multi;C:\Python27\symbols;srv*c:\Symbols*http://msdl.microsoft.com/download/symbols

Debug References:

Further Resources