@@ -72,11 +72,9 @@ <h1 class="title">Testing the JDK</h1>
7272< li > < a href ="#non-us-locale " id ="toc-non-us-locale "> Non-US
7373locale</ a > </ li >
7474< li > < a href ="#pkcs11-tests " id ="toc-pkcs11-tests "> PKCS11 Tests</ a > </ li >
75- </ ul > </ li >
7675< li > < a href ="#testing-ahead-of-time-optimizations "
77- id ="toc-testing-ahead-of-time-optimizations "> ### Testing Ahead-of-time
78- Optimizations</ a >
79- < ul >
76+ id ="toc-testing-ahead-of-time-optimizations "> Testing Ahead-of-time
77+ Optimizations</ a > </ li >
8078< li > < a href ="#testing-with-alternative-security-providers "
8179id ="toc-testing-with-alternative-security-providers "> Testing with
8280alternative security providers</ a > </ li >
@@ -435,6 +433,9 @@ <h4 id="jcov_diff_changeset">JCOV_DIFF_CHANGESET</h4>
435433< p > The report is stored in
436434< code > build/$BUILD/test-results/jcov-output/diff_coverage_report</ code >
437435file.</ p >
436+ < h4 id ="aot_jdk "> AOT_JDK</ h4 >
437+ < p > See < a href ="#testing-ahead-of-time-optimizations "> Testing
438+ Ahead-of-time optimizations</ a > .</ p >
438439< h3 id ="jtreg-keywords "> JTReg keywords</ h3 >
439440< h4 id ="jobs-1 "> JOBS</ h4 >
440441< p > The test concurrency (< code > -concurrency</ code > ).</ p >
@@ -457,6 +458,12 @@ <h4 id="test_thread_factory">TEST_THREAD_FACTORY</h4>
457458< code > test/jtreg_test_thread_factory/</ code > directory. This class gets
458459compiled during the test image build. The implementation of the Virtual
459460class creates a new virtual thread for executing each test class.</ p >
461+ < h4 id ="jvmti_stress_agent "> JVMTI_STRESS_AGENT</ h4 >
462+ < p > Executes JTReg tests with JVM TI stress agent. The stress agent is
463+ the part of test library and located in
464+ < code > test/lib/jdk/test/lib/jvmti/libJvmtiStressAgent.cpp</ code > . The
465+ value of this argument is set as JVM TI agent options. This mode uses
466+ ProblemList-jvmti-stress-agent.txt as an additional exclude list.</ p >
460467< h4 id ="test_mode "> TEST_MODE</ h4 >
461468< p > The test mode (< code > agentvm</ code > or < code > othervm</ code > ).</ p >
462469< p > Defaults to < code > agentvm</ code > .</ p >
@@ -556,6 +563,12 @@ <h4 id="results_format">RESULTS_FORMAT</h4>
556563same values as < code > -rff</ code > , i.e., < code > text</ code > ,
557564< code > csv</ code > , < code > scsv</ code > , < code > json</ code > , or
558565< code > latex</ code > .</ p >
566+ < h4 id ="test_jdk "> TEST_JDK</ h4 >
567+ < p > The path to the JDK that will be used to run the benchmarks.</ p >
568+ < p > Defaults to < code > build/<CONF-NAME>/jdk</ code > .</ p >
569+ < h4 id ="benchmarks_jar "> BENCHMARKS_JAR</ h4 >
570+ < p > The path to the JAR containing the benchmarks.</ p >
571+ < p > Defaults to < code > test/micro/benchmarks.jar</ code > .</ p >
559572< h4 id ="vm_options-2 "> VM_OPTIONS</ h4 >
560573< p > Additional VM arguments to provide to forked off VMs. Same as
561574< code > -jvmArgs <args></ code > </ p >
@@ -601,8 +614,8 @@ <h3 id="pkcs11-tests">PKCS11 Tests</h3>
601614 JTREG="JAVA_OPTIONS=-Djdk.test.lib.artifacts.nsslib-linux_aarch64=/path/to/NSS-libs"</ code > </ pre >
602615< p > For more notes about the PKCS11 tests, please refer to
603616test/jdk/sun/security/pkcs11/README.</ p >
604- < h2 id ="testing-ahead-of-time-optimizations "> ### Testing Ahead-of-time
605- Optimizations</ h2 >
617+ < h3 id ="testing-ahead-of-time-optimizations "> Testing Ahead-of-time
618+ Optimizations</ h3 >
606619< p > One way to improve test coverage of ahead-of-time (AOT) optimizations
607620in the JDK is to run existing jtreg test cases in a special "AOT_JDK"
608621mode. Example:</ p >
0 commit comments