changeset in /hg/icedtea6: * README: Document systemtap support.

[Mark Wielaard]

changeset 9d89e1ada1c8 in /hg/icedtea6
details: http://icedtea.classpath.org/hg/icedtea6?cmd=changeset;node=9d89e1ada1c8
description:
	* README: Document systemtap support.
		* INSTALL: Document build requirements for systemtap support.
		* NEWS: Mention systemtap support.

diffstat:

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

diffs (69 lines):

diff -r 5792b1816fac -r 9d89e1ada1c8 ChangeLog
--- a/ChangeLog	Wed Apr 29 09:28:35 2009 -0400
+++ b/ChangeLog	Wed Apr 29 16:01:07 2009 +0200
@@ -1,3 +1,9 @@ 2009-04-29  Omair Majid  <omajid at redhat.
+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  Omair Majid  <omajid at redhat.com>
 
 	* patches/icedtea-java2d-mitre-join.patch: New patch. Backport fix for
diff -r 5792b1816fac -r 9d89e1ada1c8 INSTALL
--- a/INSTALL	Wed Apr 29 09:28:35 2009 -0400
+++ b/INSTALL	Wed Apr 29 16:01:07 2009 +0200
@@ -39,6 +39,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 5792b1816fac -r 9d89e1ada1c8 NEWS
--- a/NEWS	Wed Apr 29 09:28:35 2009 -0400
+++ b/NEWS	Wed Apr 29 16:01:07 2009 +0200
@@ -1,3 +1,12 @@ New in release 1.4 (2009-01-29)
+New in release 1.X (UNRELEASED)
+
+- 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.4 (2009-01-29)
 
 - Security fixes for:
diff -r 5792b1816fac -r 9d89e1ada1c8 README
--- a/README	Wed Apr 29 09:28:35 2009 -0400
+++ b/README	Wed Apr 29 16:01:07 2009 +0200
@@ -153,3 +153,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.