RFR: 8307480: Improve SA "transported core" documentation for windows [v2]

[Kevin Walls]

On Tue, 9 May 2023 00:01:09 GMT, Chris Plummer <cjplummer at openjdk.org> wrote:

>> The SA document `transported_core.html` contains some tips on getting core files to work when debugging it on a machine other than the one that produced it. There are a few improvements that can be made based on information provided in [JDK-8306437](https://bugs.openjdk.org/browse/JDK-8306437) and in the #13530 review (which was eventually pulled as not necessary).
>> 
>> Updates to the document include the use of `sun.jvm.hotspot.debugger.windbg.imagePath` and `sun.jvm.hotspot.debugger.windbg.symbolPath` properties, and adding "`srv*https://msdl.microsoft.com/download/symbols`" to symbolPath.
>> 
>> The rendered html file with these changes can be found here:
>> https://htmlpreview.github.io/?https://raw.githubusercontent.com/openjdk/jdk/7f6345fdc90ba78e16a630b31e3f2507d685b3fa/src/jdk.hotspot.agent/doc/transported_core.html
>
> Chris Plummer has updated the pull request incrementally with one additional commit since the last revision:
> 
>   minor rewording

Marked as reviewed by kevinw (Committer).

src/jdk.hotspot.agent/doc/transported_core.html line 107:

> 105: jhsdb -J-Dsun.jvm.hotspot.debugger.windbg.symbolPath="%PATH%;srv*https://msdl.microsoft.com/download/symbol" clhsdb
> 106: </code>
> 107: 

If you are not seeing symbols for Windows libraries, try setting sun.jvm.hotspot.debugger.windbg.symbolPath to include "srv*https://msdl.microsoft.com/download/symbols". Usually also include PATH, for example:

jhsdb -J-Dsun.jvm.hotspot.debugger.windbg.symbolPath="%PATH%;srv*https://msdl.microsoft.com/download/symbol" clhsdb

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

PR Review: https://git.openjdk.org/jdk/pull/13849#pullrequestreview-1418893211
PR Review Comment: https://git.openjdk.org/jdk/pull/13849#discussion_r1188766596