Mercurial > hg > truffle
comparison agent/doc/ReadMe-JavaScript.text @ 0:a61af66fc99e jdk7-b24
Initial load
| author | duke |
|---|---|
| date | Sat, 01 Dec 2007 00:00:00 +0000 |
| parents | |
| children |
comparison
equal
deleted
inserted
replaced
| -1:000000000000 | 0:a61af66fc99e |
|---|---|
| 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. |