How to use the NIST Net emulation package

Before running NIST Net, the kernel emulator module must be installed through Load.Nistnet or insmod nistnet. You can add this to /etc/rc.d/rc.modules if you wish.

To control the emulator, several tools are included in the package.


Cnistnet is the new command-line interface. It takes the following arguments:
up (on)
down (off)
-a src[:port[.protocol]] dest[:port[.prot]] [cos]
add new
[--delay delay [delsigma[/delcorr]]]
[--drop drop_percentage[/drop_correlation]]
[--dup dup_percentage[/dup_correlation]]
[--bandwidth bandwidth]
[--drd drdmin drdmax [drdcongest]]
-r src[:port[.prot]] dest[:port[.prot]] [cos]
-s src[:port[.prot]] dest[:port[.prot]] [cos]
see stats
-S src[:port[.prot]] dest[:port[.prot]] [cos]
see stats continuously
[-n] -R
read current settings (-n numerical format)
-D value
debug on (value=0 none, 1 minimal,... 9 maximal)
debug off
global stats
kickstart the clock
flush the queues
this help message


Hitbox is the old command-line interface. It takes the following arguments:
up (turn emulator on)
down (turn emulator off - entries are retained)
-a src dest delay delsigma bandwidth drop dup drdmin drdmax
add new entry
-r src dest
remove entry
-s src dest
see stats for entry
-S src dest
see stats for entry continuously
read current list of entries in kernel
debug on
debug off
see global stats


Nistnet is the GUI version of the user interface. It provides for control and monitoring of multiple entries. These diagrams show the controls xnistnet offers. Note: these need to be updated!! Usage diagram 1 Usage diagram 2 Usage diagram 3
Comments? Questions? Let us know at
[ NIST Net Home Page] [Installing NIST Net] [Using NIST Net] [NIST Net FAQ]