NSPR has a test suite in the mozilla/nsprpub/pr/tests
directory.
By default, we don't build the test programs. Running gmake
in the top-level directory (mozilla/nsprpub
) only builds the NSPR libraries. To build the test programs, you need to change directory to mozilla/nsprpub/pr/tests
and run gmake
. Refer to NSPR build instructions for details.
To run the test suite, run the shell script mozilla/nsprpub/pr/tests/runtests.sh
in the directory where the test program binaries reside, for example,
cvs -q co -r NSPR_4_6_6_RTM mozilla/nsprpub mkdir linux.debug cd linux.debug ../mozilla/nsprpub/configure gmake cd pr/tests gmake ../../../mozilla/nsprpub/pr/tests/runtests.sh
The output of the test suite looks like this:
NSPR Test Results - tests BEGIN Mon Mar 12 11:44:41 PDT 2007 NSPR_TEST_LOGFILE /dev/null Test Result accept Passed acceptread Passed acceptreademu Passed affinity Passed alarm Passed anonfm Passed atomic Passed attach Passed bigfile Passed cleanup Passed cltsrv Passed concur Passed cvar Passed cvar2 Passed ... sprintf FAILED ... timetest Passed tpd Passed udpsrv Passed vercheck Passed version Passed writev Passed xnotify Passed zerolen Passed END Mon Mar 12 11:55:47 PDT 2007
How to determine if the test suite passed
If all the tests reported Passed as the results, the test suite passed.
What if some of the tests crashed or reported FAILED as the results? It doesn't necessarily mean the test suite failed because some of the test programs are known to fail. Sun's NSS team is working on fixing these test failures. Until the test failures are fixed, you should run NSPR tests against a known good version of NSPR on the same platform, and save the test results as the benchmark. Then you can detect regressions of the new version by comparing its test results with the benchmark.
Known issues
Other issues with the NSPR test suite are:
- Some of the test programs test the accuracy of the timeout of NSPR functions. Since none of our operating systems is a real-time OS, such test programs may fail when the test machine is heavily loaded.
- Some tests, such as
pipepong
andsockpong
, should not be run directly. They will be invoked by their companion test programs (e.g.,pipeping
andsockping
). This is not an issue if you runruntests.sh
becauseruntests.sh
knows not to run such test programs directly.