|
From: <sv...@va...> - 2006-06-02 23:57:26
|
Author: njn Date: 2006-06-03 00:57:22 +0100 (Sat, 03 Jun 2006) New Revision: 5951 Log: Add documentation on how to run the performance suite. Modified: trunk/NEWS trunk/README_DEVELOPERS Modified: trunk/NEWS =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- trunk/NEWS 2006-06-02 22:58:34 UTC (rev 5950) +++ trunk/NEWS 2006-06-02 23:57:22 UTC (rev 5951) @@ -83,7 +83,7 @@ have been fixed. =20 - A simple performance evaluation suite has been added. See - perf/README for details. "make perf" runs the tests. There are + perf/README and README_DEVELOPERS for details. There are various bells and whistles. =20 - New configuration flags: Modified: trunk/README_DEVELOPERS =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- trunk/README_DEVELOPERS 2006-06-02 22:58:34 UTC (rev 5950) +++ trunk/README_DEVELOPERS 2006-06-02 23:57:22 UTC (rev 5951) @@ -33,6 +33,30 @@ perl tests/vg_regtest memcheck/tests/badfree =20 =20 +Running the performance suite +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +To build and run the whole performance suite, run "make [--quiet] perf". + +To run a subset of the regression tests, execute: + + perl perf/vg_perf <name> + +where <name> is a directory (all tests within will be run) or a single +.vgperf test file, or the name of a program which has a like-named .vgpe= rf +file. Eg: + + perl perf/vg_perf perf/ + perl perf/vg_perf perf/bz2.vgperf + perl perf/vg_perf perf/bz2 + +To compare multiple versions of Valgrind, use the --vg=3D options multip= le +times. For example, if you have two Valgrinds next to each other, one i= n +trunk1/ and one in trunk2/, from either trunk1/ or trunk2/ do this to +compare them on the entire suite: + + perl perf/vg_perf --vg=3D../trunk1 --vg=3D../trunk2 perf/ + + Debugging Valgrind with GDB ~~~~~~~~~~~~~~~~~~~~~~~~~~~ To debug the valgrind launcher program (<prefix>/bin/valgrind) just |