Documentation: Adding flag descriptions of unit test scripts

Let's append the meaning of the 'priority' and 'gcstresslevel' flag.
The additional description of the 'priority' flag  is derived from
./coreclr/tests/dir.props. And, that of the 'gcstresslevel' flag is
derived from ./coreclr/src/gc/sample/gcenv.h.

ver2:
Moved 'gcstresslevel' flag from ./tests/buildtest.cmd to ./tests/runtest.*.

ver1:
Added 'priority' and 'gcstresslevel' flag in ./tests/buildtest.cmd

Signed-off-by: Geunsik Lim <geunsik.lim@samsung.com>
Commit migrated from https://github.com/dotnet/coreclr/commit/38640b47ce6e95dbcdf5ed9ddc3b8e18182d949b

diff --git a/src/coreclr/tests/buildtest.cmd b/src/coreclr/tests/buildtest.cmd
index 7cec452..37acb76 100644 (file)
--- a/src/coreclr/tests/buildtest.cmd
+++ b/src/coreclr/tests/buildtest.cmd
@@ -365,6 +365,9 @@ echo clean: force a clean build ^(default is to perform an incremental build^).
 echo CrossGen: enables the tests to run crossgen on the test executables before executing them. 
 echo msbuildargs ... : all arguments following this tag will be passed directly to msbuild.
 echo priority ^<N^> : specify a set of test that will be built and run, with priority N.
+echo     0: Build only priority 0 cases as essential testcases (default)
+echo     1: Build all tests with priority 0 and 1
+echo     666: Build all tests with priority 0, 1 ... 666
 echo sequential: force a non-parallel build ^(default is to build in parallel
 echo     using all processors^).
 echo longgctests: Build tests so that runtests.cmd will do a long-running GC test.

diff --git a/src/coreclr/tests/runtest.cmd b/src/coreclr/tests/runtest.cmd
index 03b783e..ef5b4fe 100644 (file)
--- a/src/coreclr/tests/runtest.cmd
+++ b/src/coreclr/tests/runtest.cmd
@@ -356,6 +356,9 @@ echo jitstressregs n    - Runs the tests with COMPlus_JitStressRegs=n
 echo jitminopts         - Runs the tests with COMPlus_JITMinOpts=1
 echo jitforcerelocs     - Runs the tests with COMPlus_ForceRelocs=1
 echo gcstresslevel n    - Runs the tests with COMPlus_GCStress=n
+echo     0: None                                1: GC on all allocs and 'easy' places
+echo     2: GC on transitions to preemptive GC  4: GC on every allowable JITed instr
+echo     8: GC on every allowable NGEN instr   16: GC only on a unique stack trace
 echo CORE_ROOT The path to the runtime  
 exit /b 1
 

diff --git a/src/coreclr/tests/runtest.sh b/src/coreclr/tests/runtest.sh
index d4cb111..4a957f2 100755 (executable)
--- a/src/coreclr/tests/runtest.sh
+++ b/src/coreclr/tests/runtest.sh
@@ -51,6 +51,10 @@ function print_usage {
     echo '  --jitstressregs=<n>              : Runs the tests with COMPlus_JitStressRegs=n'
     echo '  --jitminopts                     : Runs the tests with COMPlus_JITMinOpts=1'
     echo '  --jitforcerelocs                 : Runs the tests with COMPlus_ForceRelocs=1'
+    echo '  --gcstresslevel n                : Runs the tests with COMPlus_GCStress=n'
+    echo '    0: None                                1: GC on all allocs and 'easy' places'
+    echo '    2: GC on transitions to preemptive GC  4: GC on every allowable JITed instr'
+    echo '    8: GC on every allowable NGEN instr   16: GC only on a unique stack trace'
     echo ''
     echo 'Runtime Code Coverage options:'
     echo '  --coreclr-coverage               : Optional argument to get coreclr code coverage reports'