Centre for Advanced Internet Architectures,
Swinburne University of Technology,
Melbourne, Australia
CRICOS number 00111D

4th August, 2010


----------------------------------------------
OVERVIEW
----------------------------------------------

This package contains various minor patches for ns-2.33 that add normally
distributed random jitter to cbr packets, and a dummynet style droptail queue
mechanism.

----------------------------------------------
LICENCE
----------------------------------------------

These patches are released under a BSD licence. Refer to LICENSE.txt for further
details.


----------------------------------------------
DETAILS
----------------------------------------------

ns-2_33_tools_cbr_traffic.patch

	Patch to cbr_traffic.cc to provide normally distributed random jitter of
	cbr packets.

	To apply:
	 - go to the "ns-2.33/tools" directory
	 - run "patch < ns-2_33_tools_cbr_traffic.patch"

ns-2_33_queue_queue.patch Patch to drop-tail.cc, queue.cc, and queue.h that
	provides a dummynet like droptail mechanism plus accounting for the
	number of bytes in the queue.

	To apply:
	 - go to the "ns-2.33/queue" directory
	 - run "patch < ns-2_33_queue_queue.patch"


ns-2_33_tcl_lib.patch
	Patch to ns-default.tcl and ns-source.tcl that makes the necessary
	parameters for achieving the above functionality available for the ns2
	tcl simulation model configuration.
	
	To apply:
	- go to the "ns-2.33/tcl/lib" directory
	- run "patch < ns-2_33_tcl_lib.patch"


After applying the above patches, ns2 will need to be recompiled to gain this
functionality.

----------------------------------------------
USAGE
----------------------------------------------

Tcl example for using normally distributed random jitter for a CBR source with
an inter-packet interval of 20ms and the standard deviation of the jitter 1ms:
	set cbr1 [new Application/Traffic/CBR]
	$cbr1 set interval_ 0.02
	$cbr1 set random_ 1
	$cbr1 set normalstd_ 0.001


Tcl example to set up fixed byte dummynet type droptail queueing:
     Queue/DropTail set dummynet_ 1




----------------------------------------------
AUTHORS
----------------------------------------------

The changes contained in the above patches were made by David Hayes and Michael
Welzl while at the Centre for Advanced Internet Architecture, Swinburne
University of Technology. 


----------------------------------------------
References
----------------------------------------------

[1] "The network simulator - ns-2," [Online] http://www.isi.edu/nsnam/ns/

[2] L. Rizzo, "Dummynet: a simple approach to the evaluation of network
    protocols," ACM SIGCOMM Computer Communication Review, vol. 27, no. 1,
    pp. 31-41, 1997.