thrulay-hd

What is thrylay-hd?
New Features
Documentation
Downloads
Feedbacks

What is thrylay-hd?

thrulay stands for THRUput and deLAY. It is a software package initially created by Stanislav Shalunov. thrulay measures the capacity of a network by sending a bulk TCP stream over it and measures one-way delay by sending a Poisson stream of very precisely positioned UDP packets. hd is not a particular feature (e.g. Highly Dependable :)) or extension to thrulay. It is used to make a distinction to another Google Summer of Code project thrulay-ng. Both projects are memtored by Jeff W. Boote @Internet2 and aim to improve the original thrulay (0.6). Does ng stand for "next generation"? Go to thrulay-ng and ask Bernhard Lutzmann :).

New Features

• Multiple TCP and UDP streams using a event based implementation (for the differences between process/thread/event based implmentation, please refer to Stanislav Shalunov's excellent article);
• API for programmatic execution of thrulay tests;
• Plat form independent (currently running on Linux, Solaris, FreeBSD and Mac OS X);
• Online calculation of 0/50/95th quantile of one way delay and number of loss periods;
• IPv6 support and client address based authentication.

Documentation

Command Line Tools

• thrulay
• thrulayd

API

• thrulay_init
• thrulay_open
• thrulay_start
• thrulay_wait
• thrulay_close
• thrulay_exit
• thrulay_get_setup
• thrulay_get_report
• thrulay_err_msg

Project Report

• ps version of the report
• pdf version of the report

Examples

• The thrulay client code itself (thrulay.c) is an example of how to use the above APIs.
• thrulay_tu.c in the example directory is another example. A example Makefile is also provided for thrulay_tu.c.

Downloads

You can download the thrulay-hd-0.6.4 tarball or checkout the latest code from CVS anonymously by typing

cvs -d:pserver:anonymous@cvs.sf.net:/cvsroot/thrulay-hd login

cvs -d:pserver:anonymous@cvs.sf.net:/cvsroot/thrulay-hd checkout -P thrulay-hd

Build from a distribution is quite standard, simply type configure, make, and make install. Note that the default installation path is ``<thrulay-package-dir>/local/". You can specify an installation prefix other than that by using the option --prefix=PATH. If you want to use the fasttime library, use --with-libfasttime=DIR as a configure option. DIR is the path where fasttime is installed. It is highly recommended that you start fasttimed before running thrulayd or thrulay tests.

To build from CVS, if you have automake 1.7.9 and autoconf 2.58, type bootstrap, otherwise, type touch_files before invoking the standard build process.

Feedbacks

Feel free to contack me if you have any comment or question. Your feedbacks are very important to me. Thank you.