JDI VirtualThreads.allThreads (and JDWP VirtualMachine/AllThreads) continue to enumerate all platform threads.
Thread groups
Virtual threads are not active members of a thread group.
JDI ThreadGroupReference::threads (and JDWP ThreadGroupReference/Children) continue to enumerate all platform threads in the group.
removeVirtualThreadFilter that can be used to remove the filtering of thread start/end events for virtual threads. This may be changed so that JDI clients opt-in to filter rather than opt-out.
ThreadStartRequest/ThreadDeathRequest define a new methodNot Supported
The following are not currently supported for virtual threads:
- JDI ThreadReference.stop
- JDI ThreadReference.interrupt
- JDI StackFrame.setValue
JDWP agent options
As a temporary solution to allow existing debuggers work with virtual threads, the JDWP agent will track virtual threads so they can be enumerated for debuggers that want to enumerate all virtual threads. The options that control this behaviour are:
Option Name and Value | Description | Default |
---|---|---|
trackvthreads=some|all | track some or all vthreads | some |
enumeratevthreads=y|n | thread lists include vthreads | y |
fakevthreadstartevent=y|n | send fake start event when needed | y |
- enumeratevthreads control whether or not virtual threads are included in list of threads returned by JDWP VirtualThread/AllThreads and ThreadGroupReference/Children commands.
- trackvthreads controls which virtual threads will be returned when enumeratevthreads=y.
- fakevthreadstartevent is independent of the two others. If y, then before sending an event, send a fake THREAD_START event for if the debugger hasn’t already been notified about the virtual thread that the event occurs on. Note currently there is a bug, and if trackvthreads=all, no fake THREAD_START will ever be sent. This is only an issue if the debug agent is started after some virtual threads have been created.