Tests are typically run using the high level ``test.py`` program.  They

Tests are typically run using the high level ``test.py`` program. To get a list of the available command-line options, run ``test.py --help``

can also be run manually using a low level test-runner executable directly

from ``waf``.  

Running Tests Under the Test Runner Executable

Debugging Tests

**********************************************

***************

The test-runner is the bridge from generic Python code to |ns3| code.

The debugging of the test programs is best performed running the low-level test-runner program. The test-runner is the bridge from generic Python code to |ns3| code. It is written in C++ and uses the automatic test discovery process in the 

It is written in C++ and uses the automatic test discovery process in the 

Although it may not be used directly very often, it is good to understand how

The main reason why ``test.py`` is not suitable for deugging is that it is not allowed for logging to be turned on using the ``NS_LOG`` environmental variable when test.py runs.  This limitation does not apply to the test-runner executable. Hence, if you want to see logging output from your tests, you have to run them using the test-runner directly.

``test.py`` actually runs the various tests.