annotate agent/doc/ReadMe-JavaScript.text @ 3611:df57f6208cb7

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