0
|
1 The HotSpot Serviceability Agent (SA) is a debugger for hotspot core
|
|
2 dumps and hung processes. There is a read-only JDI (Java Debugger
|
|
3 Interface) implementation on top of SA. This is part of JDK product and
|
|
4 the classes are in $JDK/tools/sa-jdi.jar.
|
|
5
|
|
6 In addition, there are few serviceability tools in $JDK/bin, namely,
|
|
7 jstack (java stack trace tool), jmap (heap tool), jinfo (Java config
|
|
8 tool) and jsadebugd. The classes for these are also in sa-jdi.jar
|
|
9 file. sa-jdi.jar file is built along with hotspot (libjvm.so) on Solaris
|
|
10 and Linux platforms. On Windows platform, SA-JDI is not included and
|
|
11 serviceability tools do not use SA.
|
|
12
|
|
13 Apart from these, HotSpot SA consists of a number of tools that are
|
|
14 *not* included in JDK product bits.
|
|
15
|
|
16 The sources and makefile for all-of-SA (including non-productized stuff)
|
|
17 are under $HOTSPOT_WS/agent directory. The makefile $HOTSPOT/agent/make
|
|
18 directory and shell scripts (and batch files) are used to build and run
|
|
19 SA non-product tools. There is also documentation of SA under
|
|
20 $HOTSPOT/agent/doc directory.
|
|
21
|
|
22 To build complete SA, you need to have Rhino Mozilla jar (js.jar)
|
|
23 version 1.5R5 under $HOTSPOT/agent/src/share/lib directory. Rhino is
|
|
24 JavaScript interpreter written in Java. Rhino is used to implement SA
|
|
25 features such as
|
|
26
|
|
27 * SA command line debugger's JavaScript interface
|
|
28 - refer to $HOTSPOT/agent/doc/clhsdb.html
|
|
29 - refer to $HOTSPOT/agent/doc/jsdb.html
|
|
30 * SA simple object query language (SOQL)
|
|
31 - language to query Java heap.
|
|
32
|
|
33 Rhino's "js.jar" is not included in hotspot source bundles. You need to
|
|
34 download it from http://www.mozilla.org/rhino/download.html.
|
|
35
|
|
36 Without js.jar, $HOTSPOT/agent/make/Makefile will fail to build. But,
|
|
37 note that sa-jdi.jar containing the productized portions of SA will
|
|
38 still be built when you build hotspot JVM.
|