Summary

Update the JVM TI spec to make it clear that the functions SuspendAllVirtualThreads and ResumeAllVirtualThreads require the capabilities can_suspend and can_support_virtual_threads.

Problem

JEP 425 updated the JVM TI spec to add SuspendAllVirtualThreads and ResumeAllVirtualThreads as preview APIs. The specification currently states that these functions require the can_suspend or can_support_virtual_threads capabilities when it should say that they require both capabilities.

Solution

Change the specification of SuspendAllVirtualThreads and ResumeAllVirtualThreads to require both capabilities.

Specification

The Capabilities section of both functions is changed from:

"One of the following capabilities (as returned by GetCapabilities) must be true to use this function."

to

"The following capabilities (as returned by GetCapabilities) must be true to use this function."

and the misleading sentence:

"If this capability is enabled then the following functions can be called: SuspendAllVirtualThreads, ResumeAllVirtualThreads, and the following events can be enabled: VirtualThreadStart, VirtualThreadEnd"

is dropped from the description of the can_support_virtual_threads capability in both functions.

A specdiff is attached so that it is clear what has changed.