Fwd: jdwp documentation for Java 9+

[Chris Plummer]

On 6/16/22 6:12 AM, David Holmes wrote:
> On 16/06/2022 8:07 pm, S A wrote:
>> Hi all,
>>
>> where can I find jwdp documentation (including list of arguments) for 
>> Java 9+?
>
> Unfortunately we seem to be missing links to all of the specs in the 
> JDK 9, 10 and 11, documentation bundles online. They reappear again 
> with Java 12:
>
> https://docs.oracle.com/en/java/javase/12/docs/specs/

Unfortunately even with the link to the specs in place, it's still hard 
getting to the conninv.html file that Alan referenced. You start by 
clicking on Java Platform Debugger Architecture, which takes you to:

https://docs.oracle.com/en/java/javase/12/docs/specs/jpda/jpda.html

Then you scroll to the very bottom and click on the Service Provider 
Interface link, which takes you to conninv.html. You can find 
documentation for the debug agent command line options in the Oracle VM 
Invocation Options section.

Chris

>
> David
> -----
>
>> Background:
>>
>> A colleague of mine ran into this issue: 
>> https://bugs.openjdk.org/browse/JDK-8175050 
>> <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 
>> <https://bugs.openjdk.java.net/browse/JDK-8041435> (I've tried 
>> finding the change in the JDK repositories to no avail)
>>
>> 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> 
>>
>>
>> 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 
>> <https://docs.oracle.com/javase/8/docs/technotes/guides/jpda/jdwp-spec.html> 
>>
>>
>> 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