386 The `TIMEOUT_FACTOR` is forwarded to JTReg framework itself
387 (`-timeoutFactor`). Also, some test cases that programmatically wait a
388 certain amount of time will apply this factor. If we run in forced
389 compilation mode (`-Xcomp`), the build system will automatically
390 adjust this factor to compensate for less performance. Defaults to 4.
391
392 #### FAILURE_HANDLER_TIMEOUT
393
394 Sets the argument `-timeoutHandlerTimeout` for JTReg. The default value is 0.
395 This is only valid if the failure handler is built.
396
397 #### TEST_THREAD_FACTORY
398
399 Sets the `-testThreadFactory` for JTReg. It should be the fully qualified
400 classname of a class which implements `java.util.concurrent.ThreadFactory`. One
401 such implementation class, named Virtual, is currently part of the JDK build in
402 the `test/jtreg_test_thread_factory/` directory. This class gets compiled
403 during the test image build. The implementation of the Virtual class creates a
404 new virtual thread for executing each test class.
405
406 #### JVMTI_STRESS_AGENT
407
408 Executes JTReg tests with JVM TI stress agent. The stress agent is the part of
409 test library and located in `test/lib/jdk/test/lib/jvmti/libJvmtiStressAgent.cpp`.
410 The value of this argument is set as JVM TI agent options.
411 This mode uses ProblemList-jvmti-stress-agent.txt as an additional exclude list.
412
413 #### TEST_MODE
414
415 The test mode (`agentvm` or `othervm`).
416
417 Defaults to `agentvm`.
418
419 #### ASSERT
420
421 Enable asserts (`-ea -esa`, or none).
422
423 Set to `true` or `false`. If true, adds `-ea -esa`. Defaults to true, except
424 for hotspot.
425
|
386 The `TIMEOUT_FACTOR` is forwarded to JTReg framework itself
387 (`-timeoutFactor`). Also, some test cases that programmatically wait a
388 certain amount of time will apply this factor. If we run in forced
389 compilation mode (`-Xcomp`), the build system will automatically
390 adjust this factor to compensate for less performance. Defaults to 4.
391
392 #### FAILURE_HANDLER_TIMEOUT
393
394 Sets the argument `-timeoutHandlerTimeout` for JTReg. The default value is 0.
395 This is only valid if the failure handler is built.
396
397 #### TEST_THREAD_FACTORY
398
399 Sets the `-testThreadFactory` for JTReg. It should be the fully qualified
400 classname of a class which implements `java.util.concurrent.ThreadFactory`. One
401 such implementation class, named Virtual, is currently part of the JDK build in
402 the `test/jtreg_test_thread_factory/` directory. This class gets compiled
403 during the test image build. The implementation of the Virtual class creates a
404 new virtual thread for executing each test class.
405
406 #### VALUE_CLASS_PLUGIN
407
408 Enables the `ValueClassPlugin` javac plugin when compiling and running JTReg
409 tests. This is a **temporary mode** intended for use while value classes
410 (JEP 401) are a preview feature. The long-term plan is to replace classes
411 annotated with `@jdk.test.lib.valueclass.AsValueClass` with plain
412 `value class` declarations once value classes are finalized.
413
414 In the meantime, this mode allows test sources to compile and run as either
415 value classes or regular identity classes without source-level changes.
416
417 When set to any non-empty value, the following options are appended to every
418 JTReg invocation:
419
420 * `-cpa:<valueClassPlugin.jar>` — appends the plugin JAR to the compile-time
421 classpath (only when the JAR is present in the test image under
422 `jtreg_value_class_plugin/valueClassPlugin.jar`).
423 * `-vmoption:--enable-preview` — enables JVM preview features at runtime.
424 * `-javacoption:-XDaccessInternalAPI` — grants the compiler access to internal
425 APIs required by the plugin.
426 * `-javacoption:--source <version> --enable-preview` — enables preview language
427 features at compile time.
428 * `-javacoption:-Xplugin:ValueClassPlugin` — activates the plugin.
429
430 The plugin scans each compilation unit after parsing and converts any class
431 annotated with `@jdk.test.lib.valueclass.AsValueClass` into a value class by
432 setting the internal `VALUE_CLASS` modifier flag and clearing the
433 `IDENTITY_TYPE` flag. This transformation only takes effect when
434 `--enable-preview` is active; without it the annotation is a no-op and the
435 class compiles as an ordinary identity class, so the same test source can
436 exercise both code paths.
437
438 Example:
439
440 $ make test TEST=jdk_lang JTREG="VALUE_CLASS_PLUGIN=true"
441
442 #### JVMTI_STRESS_AGENT
443
444 Executes JTReg tests with JVM TI stress agent. The stress agent is the part of
445 test library and located in `test/lib/jdk/test/lib/jvmti/libJvmtiStressAgent.cpp`.
446 The value of this argument is set as JVM TI agent options.
447 This mode uses ProblemList-jvmti-stress-agent.txt as an additional exclude list.
448
449 #### TEST_MODE
450
451 The test mode (`agentvm` or `othervm`).
452
453 Defaults to `agentvm`.
454
455 #### ASSERT
456
457 Enable asserts (`-ea -esa`, or none).
458
459 Set to `true` or `false`. If true, adds `-ea -esa`. Defaults to true, except
460 for hotspot.
461
|