README.md

Ocelot

Ocelot is a BitTorrent tracker written in C++ for the Gazelle project. It supports requests over TCP and can only track IPv4 peers.

Ocelot Compile-time Dependencies

• GCC/G++ (4.7+ required; 4.8.1+ recommended)
• Boost (1.55.0+ required)
• libev (required)
• MySQL++ (3.2.0+ required)
• TCMalloc (optional, but strongly recommended)

apt install \
	automake \
	g++ \
	gcc \
	libboost-dev \
	libboost-iostreams-dev \
	libboost-system-dev \
	libev-dev \
	libmysql++-dev \
	libtcmalloc-minimal4 \
	make

Installation

The Gazelle installation guides include instructions for installing Ocelot as a part of the Gazelle project.

Standalone Installation

• Create the following tables according to the Gazelle database schema:

• torrents
• users_freeleeches
• users_main
• xbt_client_whitelist
• xbt_files_users
• xbt_snatched

• Edit ocelot.conf to your liking.

• Build Ocelot:

cd ocelot/
autoreconf
./configure \
	--with-boost-libdir=/usr/lib/x86_64-linux-gnu \
	--with-ev-lib=/usr/lib/x86_64-linux-gnu \
	--with-mysql-lib=/usr/lib/x86_64-linux-gnu \
	--with-mysqlpp-lib=/usr/lib/x86_64-linux-gnu
make
make install

Running Ocelot

Run-time options:

• -c <path/to/ocelot.conf> - Path to config file. If unspecified, the current working directory is used.
• -v - Print queue status every time a flush is initiated.

Signals

• SIGHUP - Reload config
• SIGUSR1 - Reload torrent list, user list and client whitelist