Fwd: jdwp documentation for Java 9+

[David Holmes]

On 17/06/2022 1:37 am, Chris Plummer wrote:
> 
> 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.

It was likely closed because it was filed against the doc team and the 
"guides" but they no longer maintain these specs. The issue should have 
been re-directed to any engineering team or else a new bug filed.

David
-----

> 
>>
>> 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