Mention perf test in testsuite/README
authorYao Qi <yao@codesourcery.com>
Wed, 16 Oct 2013 06:50:16 +0000 (14:50 +0800)
committerYao Qi <yao@codesourcery.com>
Wed, 6 Nov 2013 05:14:40 +0000 (13:14 +0800)
gdb/testsuite:

2013-11-06  Yao Qi  <yao@codesourcery.com>

* README: Mention performance tests.

gdb/testsuite/ChangeLog
gdb/testsuite/README

index 4d20ff4660639baf9182fab34f06c2f2d23b8624..726bfca04804cfe10f6ea4f3687e750faa213bec 100644 (file)
@@ -1,3 +1,7 @@
+2013-11-06  Yao Qi  <yao@codesourcery.com>
+
+       * README: Mention performance tests.
+
 2013-11-06  Yao Qi  <yao@codesourcery.com>
 
        * lib/perftest.exp: New.
index ec91b14eca5a57f4f95b83a18eda35fd55077a76..c17bd3465dedc7a6029166d092f08e280fc3e710 100644 (file)
@@ -25,6 +25,29 @@ The second is to cd to the testsuite directory and invoke the DejaGnu
 (The `site.exp' file contains a handful of useful variables like host
 and target triplets, and pathnames.)
 
+Running the Performance Tests
+*****************************
+
+GDB Testsuite includes performance test cases, which are not run together
+with other test cases, because performance test cases are slow and need
+a quiet system.  There are two ways to run the performance test cases.
+The first is to do `make check-perf' in the main build directory:
+
+       make check-perf RUNTESTFLAGS="solib.exp SOLIB_COUNT=8"
+
+The second is to cd to the testsuite directory and invoke the DejaGnu
+`runtest' command directly.
+
+       cd testsuite
+       make site.exp
+       runtest GDB_PERFTEST_MODE=both GDB_PERFTEST_TIMEOUT=4000 --directory=gdb.perf solib.exp SOLIB_COUNT=8
+
+Only "compile", "run" and "both" are valid to GDB_PERFTEST_MODE.  They
+stand for "compile tests only", "run tests only", and "compile and run
+tests" respectively.  "both" is the default.  GDB_PERFTEST_TIMEOUT
+specify the timeout, which is 3000 in default.  The result of
+performance test is appended in `testsuite/perftest.log'.
+
 Testsuite Parameters
 ********************
 
@@ -315,6 +338,10 @@ Tests that exercise a specific GDB subsystem in more depth.  For
 instance, gdb.disasm exercises various disassemblers, while
 gdb.stabs tests pathways through the stabs symbol reader.
 
+gdb.perf
+
+GDB performance tests.
+
 Writing Tests
 *************