Fwd: jdwp documentation for Java 9+

[Chris Plummer]

On 6/16/22 3:07 AM, S A wrote:
> Hi all,
>
> where can I find jwdp documentation (including list of arguments) for 
> Java 9+?
>
> Background:
>
> A colleague of mine ran into this issue: 
> https://bugs.openjdk.org/browse/JDK-8175050
>
> I've since read that with Java 9+ also the hostname should be 
> specified, to ensure remote debugging is possible. All fine.
>
> However I fail to find where this is documented. I'm unable to access 
> the ticket for the change: 
> https://bugs.openjdk.java.net/browse/JDK-8041435 (I've tried finding 
> the change in the JDK repositories to no avail)

That's a confidential CR, so you won't be able to access it. Any 
relevant info you need you should be able to find in JDK-8175050. The 
changeset can be found here:

http://hg.openjdk.java.net/jdk9/jdk9/jdk/rev/030dae646c6b


>
> There is a comment about updating docus, but the links are no longer 
> valid: 
> https://bugs.openjdk.org/browse/JDK-8175050?focusedCommentId=14053881&page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-14053881 
> <https://bugs.openjdk.org/browse/JDK-8175050?focusedCommentId=14053881&page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-14053881>

This CR was filed to update the docs:

https://bugs.openjdk.org/browse/JDK-8175313

But unfortunately it was closed as Will Not Fix for reasons I don't 
understand. So I don't think the user impact of JDK-8041435 was ever 
adequately documented.


>
> Last mention I find about jdwp and its parameters is for Java 8: 
> https://docs.oracle.com/javase/8/docs/technotes/guides/jpda/jdwp-spec.html
>
The jdwp spec is of very little interest to anyone other than debugger 
writers and those that work on the debug agent. Users of the debug agent 
won't find anything useful in the jdwp spec. As Alan mention, 
conninv.html is the place to look as a user of the debug agent.

Chris

> I do find blog posts and e.g. github PRs mentioning the problem and 
> resolutions. But I would like to quote an actual source and 
> documentation for our internal wikis.
>
> Best regards and thanks,
> Simeon