Skip to content

Installing

Jump to bottom Edit New page
kannibalox edited this page Nov 26, 2024 · 7 revisions

Contents

Installing

Dependencies:

  • pkg-config
  • libcurl (c-ares support for asynchronous DNS lookups is recommend)
  • zlib
  • xmlrpc-c (optional, for XMLRPC support in rtorrent, most guides will assume XMLRPC is desired)
  • cppunit (optional, only used for testing with make check)

Building from stable release tarballs

Note that if you already have a libtorrent package installed from your package manager, it may take precedence when compiling rtorrent. Simply uninstalling the package prior to building is the easiest way to ensure a clean build environment.

wget https://github.com/rakshasa/rtorrent-archive/raw/master/libtorrent-0.13.8.tar.gz
# Or with curl: curl -sSLO https://github.com/rakshasa/rtorrent-archive/raw/master/libtorrent-0.13.8.tar.gz
tar xzvf libtorrent-0.13.8.tar.gz
cd libtorrent-0.13.8/
./configure && make && make install

cd ../

wget https://github.com/rakshasa/rtorrent-archive/raw/master/rtorrent-0.9.8.tar.gz
# Or with curl: curl -sSLO https://github.com/rakshasa/rtorrent-archive/raw/master/rtorrent-0.9.8.tar.gz
tar xzvf rtorrent-0.9.8.tar.gz
cd rtorrent-0.9.8/
./configure --with-xmlrpc-c && make && make install

Building from source

In addition to the above dependencies, the autoconf tools are required to build from source. Nearly all distributions should have a package available.

git clone https://github.com/rakshasa/libtorrent.git
cd libtorrent/
autoreconf -fi && ./configure && make && make install

cd ../

git clone https://github.com/rakshasa/rtorrent.git
cd rtorrent/
autoreconf -fi && ./configure --with-xmlrpc-c && make && make install

Non-blocking hostname lookup in curl

rTorrent will block on hostname lookup during tracker requests and http downloads. You can avoid this by compiling libcurl with 'cares' support, though this will be fixed later by using seperate threads within rTorrent.

Compilation Help

(Source: old trac Compilation Help wiki page.)

This section describes some common (non-obvious) problems compiling libTorrent/rTorrent and how to fix them. It does not have general instructions for compiling, see the Installing section for that.

In general, for problems during ./configure time check the lines of config.log before the "Cache variables" section, it should have a more detailed error message to help you diagnose the problem.

libtorrent.so.5: cannot open shared object file: No such file or directory

Make sure you have $prefix/lib in either your /etc/ld.so.conf or LD_LIBRARY_PATH, where $prefix is where you installed libtorrent. To update the ld cache, run ldconfig.

No symbol information in backtraces

When rtorrent crashes, it automatically generates a backtrace (on systems which support this). For these to be useful in fixing the problem, the linker must put symbol information in the executable files (and not just in the debug information section).

This can be accomplished by putting -rdynamic in LDFLAGS and recompiling. For example, as an argument to the configure script:

./configure LDFLAGS=-rdynamic

Add any other options you need, of course. Use make clean to force a recompilation if necessary.

Error checking signedness of mincore parameter

checking signedness of mincore parameter... configure: error: failed, do *not* attempt fix this with --disable-mincore unless you are running Win32.

Problem: Most likely, no C++ compiler is installed.

Solution: Install g++ or any other competent C++ compiler.

In most cases this error message is very misleading and indicates a general inability to compile C++ code rather than a specific problem with the signedness of the mincore parameter.

Syntax error when running ./configure

./configure: syntax error near unexpected token `OPENSSL,'
./configure: `      PKG_CHECK_MODULES(OPENSSL, openssl,'

Problem: autoconf cannot find the pkg-config macros in pkg.m4

Solution:

  • Make sure pkg-config is installed, and pkg.m4 is present
  • Make sure autoconf can find pkg.m4
    • If it cannot find it even with pkg-config installed, move pkg.m4 to where aclocal expects it, which is most likely /usr/share/aclocal. If you're using MacPorts, you may be running the legacy autoconf instead of the one from MacPorts, in that case ensure that /opt/local/bin comes before /usr/bin in your PATH environment variable to run the MacPorts autoconf.
  • Run autogen.sh again
  • Run configure again

libTorrent not found by ./configure

checking for STUFF... configure: error: Package requirements (sigc++-2.0 libcurl >= 7.12.0 libtorrent >= 0.11.8) were not met: 
No package 'libtorrent' found

Problem: libtorrent.pc not installed in a place where pkg-config looks for it.

Solution:

If you have not already compiled and installed libtorrent, do this first.

If this message persists even with libtorrent installed, pkg-config cannot find the libtorrent.pc file. Most likely, you've installed libtorrent in /usr/local (or a non-standard location) and pkg-config is not configured to look there. Set the PKG_CONFIG_PATH environment variable to where libtorrent.pc may be found, e.g. using bash:

export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig

Then run configure again.

libTorrent version not detected by ./configure

checking for STUFF... configure: error: Package requirements (sigc++-2.0 libcurl >= 7.12.0 libtorrent >= 0.12.0) were not met:
Requested 'libtorrent >= 0.12.0' but version of libtorrent is

Problem: automake is too old

Solution: Upgrade automake to version 1.5 or higher, then run libtorrent's autogen.sh and configure again, and make install.

Alternatively, manually edit libtorrent.pc to show the correct version.

Compilation on Centos

Howto for installing on Centos

Add a custom footer
Add a custom sidebar
Clone this wiki locally