added ubuntu build notes by xi stan

2006-10-12 21:24:24 +00:00
parent 37541d4676
commit 81f54dee02
4 changed files with 232 additions and 7 deletions
--- a/docs/ubuntu_build_notes.rst
+++ b/docs/ubuntu_build_notes.rst
@@ -0,0 +1,97 @@
+==================================
+Building libtorrent on Ubuntu 6.06
+==================================
+
+:Date: Oct 12, 2006
+:Author: Xi Stan
+:Contact: stan8688@gmail.com
+
+Prerequisites
+=============
+
+To build libtorrent, you need the following libraries:
+
+* http://www.rasterbar.com/products/libtorrent/index.html
+* http://www.boost.org
+* http://asio.sourceforge.net/
+
+Step 1: Acquire the source code from cvs
+========================================
+
+1. Create a directory for the project::
+
+      mkdir /home/you/work
+      cd /home/you/work
+
+2. Check out ``boost``, ``libtorrent``, ``asio`` source code from cvs
+   by executing the following commands::
+
+      cvs -d:pserver:anonymous@boost.cvs.sourceforge.net:/cvsroot/boost login
+      cvs -z3 -d:pserver:anonymous@boost.cvs.sourceforge.net:/cvsroot/boost checkout boost
+      cvs -d:pserver:anonymous@boost.cvs.sourceforge.net:/cvsroot/boost logout
+
+      cvs -d:pserver:anonym...@libtorrent.cvs.sourceforge.net:/cvsroot/libtorrent login
+      cvs -z3 -d:pserver:anonym...@libtorrent.cvs.sourceforge.net:/cvsroot/libtorrent co -P libtorrent
+      cvs -d:pserver:anonym...@libtorrent.cvs.sourceforge.net:/cvsroot/libtorrent logout
+
+      cvs -d:pserver:anonym...@asio.cvs.sourceforge.net:/cvsroot/asio login
+      cvs -z3 -d:pserver:anonym...@asio.cvs.sourceforge.net:/cvsroot/asio co -P asio
+      cvs -d:pserver:anonym...@asio.cvs.sourceforge.net:/cvsroot/asio login
+
+Step 2: Building boost
+======================
+
+To build boost, first build boost-build and then use that to build
+the library themselves::
+
+   cd /home/you/boost
+   set BOOST_BUILD_PATH=/home/you/boost/tools/build/v2
+   set BOOST_ROOT=/home/you/boost
+   cd /home/you/boost/tools/build/boost-build/jam_src
+   ./build.sh
+   cp /bin.linuxx86/bjam /usr/bin
+   cd /home/you/boost
+   bjam -sTOOLS=gcc install
+
+If you're successful you will see the followinf files in ``/usr/local/lib``::
+
+   libboost_date_time-gcc-d-1_31.so
+   libboost_date_time-gcc-mt-d-1_31.so
+   libboost_date_time-gcc-1_31.so
+   libboost_date_time-gcc-mt-1_31.so
+   libboost_date_time-gcc-d-1_31.a
+   libboost_date_time-gcc-mt-d-1_31.a
+   libboost_date_time-gcc-1_31.a
+   libboost_date_time-gcc-mt-1_31.a
+
+Step 3: Copy asio into the libtorrent directory
+===============================================
+
+Execute the following command::
+
+   cp -R /home/you/asio/include/asio* /home/you/libtorrent/include/libtorrent
+
+Step 4: Building libtorrent
+===========================
+
+To use the auto tools to build libtorrent, execute the following commands::
+
+   cd /home/you/libtorrent
+   export CXXFLAGS=-I/usr/local/include/boost-1_35
+   export LDFLAGS=-L/usr/local/lib
+
+   ./configure --with-boost-date-time=boost_date_time-gcc \
+   --with-boost-filesystem=boost_filesystem-gcc \
+   --with-boost-thread=boost_thread-gcc-mt
+
+   make
+   sudo make install
+
+If successful, you will see the following file::
+
+   /usr/local/lib/libtorrent.a
+   /usr/local/lib/libtorrent.so.0
+   /usr/local/lib/libtorrent.la
+   /usr/local/lib/libtorrent.so.0.1.0
+   /usr/local/lib/libtorrent.so
+