twisterp2pblockchainnetworkbittorrentmicrobloggingipv6social-networkdhtdecentralizedtwisterarmyp2p-networktwister-servertwister-ipv6twister-core
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
75 lines
2.0 KiB
75 lines
2.0 KiB
================= |
|
libtorrent manual |
|
================= |
|
|
|
:Author: Arvid Norberg, arvid@rasterbar.com |
|
|
|
.. contents:: Table of contents |
|
:depth: 2 |
|
:backlinks: none |
|
|
|
running and building tests |
|
========================== |
|
|
|
Some of the tests of libtorrent are not self contained. For instance, in |
|
order to test the ``http_connection`` class in libtorrent, the test requires |
|
lighty_. This document outlines the requirements of the tests as well as |
|
describes how to set up your environment to be able to run them. |
|
|
|
.. _lighty: http://www.lighttpd.net |
|
|
|
lighty |
|
====== |
|
|
|
Download lighty_. I've tested with ``lighttpd-1.4.19``. If libtorrent is built |
|
with SSL support (which it is by default), lighty needs SSL support as well. |
|
|
|
To build lighty with SSL support do:: |
|
|
|
./configure --with-openssl |
|
|
|
Followed by:: |
|
|
|
sudo make install |
|
|
|
Make sure you have SSL support in lighty by running:: |
|
|
|
lighttpd -V |
|
|
|
Which gives you a list of all enabled features. |
|
|
|
delegate |
|
======== |
|
|
|
Delegate_ can act as many different proxies, which makes it a convenient |
|
tool to use to test libtorrent's support for SOCKS4, SOCKS5, HTTPS and |
|
HTTP proxies. |
|
|
|
.. _Delegate: http://www.delegate.org |
|
|
|
You can download prebuilt binaries for the most common platforms on |
|
`deletate's download page`_. Make sure to name the executable ``delegated`` |
|
and put it in a place where a shell can pick it up, in its ``PATH``. For |
|
instance ``/bin``. |
|
|
|
.. _`deletate's download page`: http://www.delegate.org/delegate/download/ |
|
|
|
OpenSSL |
|
======= |
|
|
|
In order to create an SSL certificate for lighty_, openssl is used. More |
|
specifically, the following command is issued by the test to create the |
|
certificate file:: |
|
|
|
echo -e "AU\ntest province\ntest city\ntest company\ntest department\n\ |
|
tester\ntest@test.com" | openssl req -new -x509 -keyout server.pem \ |
|
-out server.pem -days 365 -nodes |
|
|
|
This will write ``server.pem`` which is referenced in the lighty |
|
confiuration file. |
|
|
|
OpenSSL comes installed with most Linux and BSD distros, including Mac OS X. |
|
You can download it from `the openssl homepage`_. |
|
|
|
.. _`the openssl homepage`: http://www.openssl.org/ |
|
|
|
|