7189086: new hotspot build - hs24-b20
Reviewed-by: jcoomes
The HotSpot Serviceability Agent (SA) is a debugger for hotspot coredumps and hung processes. There is a read-only JDI (Java DebuggerInterface) implementation on top of SA. This is part of JDK product andthe classes are in $JDK/tools/sa-jdi.jar.In addition, there are few serviceability tools in $JDK/bin, namely,jstack (java stack trace tool), jmap (heap tool), jinfo (Java configtool) and jsadebugd. The classes for these are also in sa-jdi.jarfile. sa-jdi.jar file is built along with hotspot (libjvm.so) on Solarisand Linux platforms. On Windows platform, SA-JDI is not included andserviceability tools do not use SA.Apart from these, HotSpot SA consists of a number of tools that are*not* included in JDK product bits.The sources and makefile for all-of-SA (including non-productized stuff)are under $HOTSPOT_WS/agent directory. The makefile $HOTSPOT/agent/makedirectory and shell scripts (and batch files) are used to build and runSA non-product tools. There is also documentation of SA under$HOTSPOT/agent/doc directory.To build complete SA, you need to have Rhino Mozilla jar (js.jar)version 1.5R5 under $HOTSPOT/agent/src/share/lib directory. Rhino isJavaScript interpreter written in Java. Rhino is used to implement SAfeatures such as* SA command line debugger's JavaScript interface - refer to $HOTSPOT/agent/doc/clhsdb.html - refer to $HOTSPOT/agent/doc/jsdb.html* SA simple object query language (SOQL) - language to query Java heap. Rhino's "js.jar" is not included in hotspot source bundles. You need todownload it from http://www.mozilla.org/rhino/download.html.Without js.jar, $HOTSPOT/agent/make/Makefile will fail to build. But,note that sa-jdi.jar containing the productized portions of SA willstill be built when you build hotspot JVM.