WE ASSUME NO RESPONSIBILITY WHATSOEVER FOR USING THIS TOOL!


TimeD is a prototype implementation of a packet interleaver for Linux based on
libipq. It has been conceived to be used both for a specific traffic source
such as a video server, or a particular network path such a wireless or
 particularly congested link.

An Alpha version TimeD is currently distributed under the terms of the GNU
GPL.

For more information visit the Traffic Project web site:
http://www.grid.unina.it/Traffic

The operations performed by TimeD are described in the Technical Report:
A. Botta, A. Pescapè, "Packet interleaving from theory to practice",
Technical Report TR-DIS-INT-7-2009 Dipartimento di Informatica e Sistemistica,
University of Napoli Federico II, Italy, July 2009.
This is available on the Traffic Project web site.

********************************************************************************
COMPILATION
********************************************************************************

TimeD depends on libipq. Before compiling TimeD, please ensure that
you have libipq installed in your system.
libipq depends on netfilters. Please visit the netfilter web site
for more information:
http://www.netfilter.org

On a debian system it is sufficient to install the package "iptables-dev".

Then to compile TimeD issue the following command:
g++ -o TimeD TimeD.cpp -lipq

Note that the location of the header file libipq.h may be different on different
systems. For this reason, it may be necessary to change the second #include in
the file TimeD.h as specified in the following.
- on Debian Lenny 5.0 and Ubuntu 9.04: #include <libipq.h>
- on Ubuntu 8.04.2: #include <libipq/libipq.h>


********************************************************************************
USAGE
********************************************************************************

Load the following modules as root:
# modprobe iptable_filter
# modprobe ip_queue

Then direct into the netfilter queue the desired packets. In the following
example TCP packets in output from the host are directed into the queue:
# iptables -A OUTPUT -p TCP -j QUEUE

The start TimeD with the desired parameters:
# ./TimeD <block_lines> <block_columns> <timeout_seconds> <timeout_microseconds>



For comments or any other information please send us an email:
a.botta@unina.it, pescape@unina.it
