# HG changeset patch
# User Andrew John Hughes <ahughes@redhat.com>
# Date 1242845018 -3600
# Node ID 7a561e7b887e3f53f36858505f84f54c06c955c6
# Parent  88af6aafd853d08c11fb8f3ffd64bdb51938efc1
SystemTap forwardport.

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

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

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  Mark Wielaard  <mjw@redhat.com>
+
+	* README: Document systemtap support.
+	* INSTALL: Document build requirements for systemtap support.
+	* NEWS: Mention systemtap support.
+
 2009-04-29 Andrew John Hughes <ahughes@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
@@ -43,6 +43,15 @@
 
 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.
 
 To bootstrap IcedTea with ecj:
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,5 +1,12 @@
 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)
 
 - Security fixes for:
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 @@
 
 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.