changeset in /hg/icedtea: SystemTap forwardport.

[Andrew John Hughes]

changeset 7a561e7b887e in /hg/icedtea
details: http://icedtea.classpath.org/hg/icedtea?cmd=changeset;node=7a561e7b887e
description:
	SystemTap forwardport.

	2009-04-29  Mark Wielaard  <mjw at redhat.com>

		* README: Document systemtap support.
		* INSTALL: Document build requirements for systemtap support.
		* NEWS: Mention systemtap support.

diffstat:

4 files changed, 36 insertions(+)
ChangeLog |    6 ++++++
INSTALL   |    9 +++++++++
NEWS      |    7 +++++++
README    |   14 ++++++++++++++

diffs (68 lines):

diff -r 88af6aafd853 -r 7a561e7b887e ChangeLog
--- a/ChangeLog	Wed May 20 19:42:04 2009 +0100
+++ b/ChangeLog	Wed May 20 19:43:38 2009 +0100
@@ -1,3 +1,9 @@ 2009-04-29 Andrew John Hughes <ahughes at r
+2009-04-29  Mark Wielaard  <mjw at redhat.com>
+
+	* README: Document systemtap support.
+	* INSTALL: Document build requirements for systemtap support.
+	* NEWS: Mention systemtap support.
+
 2009-04-29 Andrew John Hughes <ahughes at redhat.com>
 
 	* Makefile.am:
diff -r 88af6aafd853 -r 7a561e7b887e INSTALL
--- a/INSTALL	Wed May 20 19:42:04 2009 +0100
+++ b/INSTALL	Wed May 20 19:43:38 2009 +0100
@@ -42,6 +42,15 @@ netbeans = 6.5
 netbeans = 6.5
 
 For building the zero-assembler port (see below), you will need libffi.
+
+For building with systemtap support (--enable-systemtap), you will need
+systemtap-sdt-devel (available since systemtap 0.9.5). This also needs
+the --with-abs-install-dir configure option to make sure the hotspot.stp.in
+tapset gets the correct installation location for the libjvm.so, it
+defaults to the root of the j2sdk-image build dir otherwise (but then
+you cannot move that to another location without adjusting the paths
+in the tapset/hotspot.stp file. For example:
+ --enable-systemtap --with-abs-install-dir=/usr/lib/jvm/java-1.6.0-openjdk
 
 See ./configure --help if you need to override the defaults.
 
diff -r 88af6aafd853 -r 7a561e7b887e NEWS
--- a/NEWS	Wed May 20 19:42:04 2009 +0100
+++ b/NEWS	Wed May 20 19:43:38 2009 +0100
@@ -1,4 +1,11 @@ New in release 1.10 (XXXX-XX-XX)
 New in release 1.10 (XXXX-XX-XX)
+
+- Static trace support through systemtap.
+  When given the configure option --enable-systemtap IcedTea will build
+  hotspot with the dtrace static markers enabled and install an hotspot
+  tapset that can be used to dynamically trace execution of java
+  applications at runtime. See the tapset/hotspot.stp file for
+  documentation of the various trace points and arguments available.
 
 New in release 1.9 (2009-03-20)
 
diff -r 88af6aafd853 -r 7a561e7b887e README
--- a/README	Wed May 20 19:42:04 2009 +0100
+++ b/README	Wed May 20 19:43:38 2009 +0100
@@ -169,3 +169,17 @@ PulseAudio Mixer
 
 Passing --enable-pulse-java to configure will build the PulseAudio Mixer for 
 java. This allows java programs to use PulseAudio as the sound backend.
+
+Systemtap support
+=================
+
+The --enable-systemtap configure option will try to find the systemtap
+runtime development files (sdt.h and the dtrace python script wrapper),
+enable compilation of static markers in the hotspot code and install a
+systemtap hotspot.stp tapset for easy tracing with systemtap's stap
+utility. The probes are documented in tapset/hotspot.stp.
+
+This requires the systemtap-sdt-devel package as build dependency and
+optionally the systemtap package at run time when the user want to use
+the tapset to trace java programs. The probes have zero overhead when
+not used and can safely be compiled in even when not used at runtime.