[prev in list] [next in list] [prev in thread] [next in thread] 

List:       openjdk-serviceability-dev
Subject:    Re: RFR: 8286983: rename jdb -trackvthreads and debug agent enumeratevthreads options and clarify "P
From:       Chris Plummer <cjplummer () openjdk ! java ! net>
Date:       2022-05-31 18:14:51
Message-ID: ZrdG7pDlOPve3rjUBGCjCenYQtRzPofckRf1W0oLR-8=.1b688b64-c1a2-411e-a113-b64bb4adb110 () github ! com
[Download RAW message or body]

> As part of the loom integration, jdb added `-trackvthreads` and the debug agent \
> added `enumeratevthreads`. These options are being renamed to `-trackallthreads` \
> and `includevirtualthreads` (the shorthand `vthreads` should not have been used). \
> Also, the help text for these options now calls out that virtual threads are a \
> Preview Feature. 
> After the update to help text, wlil look as follows:
> 
> jdb doc (search for "trackallthreads"): \
> http://cr.openjdk.java.net/~cjplummer/8286983/jdb.html debug agent doc (seach for \
> "includevirtualthreads"): \
> http://cr.openjdk.java.net/~cjplummer/8286983/conninv.html 
> 
> $ jdb -listconnectors
> ...
> Connector: com.sun.jdi.CommandLineLaunch  Transport: dt_socket
> description: Launches target using Sun Java VM command line and attaches to it
> ...
> Argument: includevirtualthreads Default value: n
> description: List of all threads includes virtual threads as well as platform \
> threads. Virtual threads are a preview feature of the Java platform. 
> 
> 
> $ jdb -help
> Usage: jdb <options> <class> <arguments>
> 
> where options include:
> ...
> -dbgtrace [flags] print info for debugging jdb
> -trackallthreads  Track all threads, including virtual threads.
> Virtual threads are a preview feature of the Java platform.
> -tclient          run the application in the HotSpot(TM) Client Compiler
> ...
> 
> 
> 
> $ man -M ./build/linux-x64-debug/images/jdk/man/ jdb
> ...
> -tclient
> Runs the application in the Java HotSpot VM client.
> 
> -trackallthreads
> Track  all  threads  as  they  are  created,  including  Virtual
> Threads.   See  Working  With  Virtual  Threads  below.  Virtual
> threads are a preview feature of the Java platform.
> 
> -tserver
> Runs the application in the Java HotSpot VM server.
> ...
> WORKING WITH VIRTUAL THREADS
> Virtual threads are a preview feature of the  Java  platform.   Preview
> features  may  be removed in a future release, or upgraded to permanent
> features of the Java platform.
> 
> Often virtual theads are created in such large  numbers  and  frequency
> ...
> 
> 
> 
> $ java -agentlib:jdwp=help
> Java Debugger JDWP Agent Library
> --------------------------------
> 
> (See the "VM Invocation Options" section of the JPDA
> "Connection and Invocation Details" document for more information.)
> 
> jdwp usage: java -agentlib:jdwp=[help]|[<option>=<value>, ...]
> 
> Option Name and Value            Description                       Default
> ---------------------            -----------                       -------
> ...
> timeout=<timeout value>          for listen/attach in milliseconds n
> includevirtualthreads=y|n        List of all threads includes virtual threads as \
> well as platform threads. Virtual threads are a preview feature of the Java \
> platform. n
> mutf8=y|n                        output modified utf-8             n
> ...

Chris Plummer has updated the pull request incrementally with one additional commit \
since the last revision:

  Don't capitalize "virtual threads"

-------------

Changes:
  - all: https://git.openjdk.java.net/jdk/pull/8780/files
  - new: https://git.openjdk.java.net/jdk/pull/8780/files/2a6f2e49..3a96fcac

Webrevs:
 - full: https://webrevs.openjdk.java.net/?repo=jdk&pr=8780&range=04
 - incr: https://webrevs.openjdk.java.net/?repo=jdk&pr=8780&range=03-04

  Stats: 1 line in 1 file changed: 0 ins; 0 del; 1 mod
  Patch: https://git.openjdk.java.net/jdk/pull/8780.diff
  Fetch: git fetch https://git.openjdk.java.net/jdk pull/8780/head:pull/8780

PR: https://git.openjdk.java.net/jdk/pull/8780


[prev in list] [next in list] [prev in thread] [next in thread]