From: Mark Wielaard <mjw@redhat.com>
Date: Thu, 1 Dec 2011 11:05:35 +0000 (+0100)
Subject: Document some new features and improvements since systemtap 1.6.
X-Git-Tag: release-1.7~148^2
X-Git-Url: https://sourceware.org/git/?a=commitdiff_plain;h=af3e4f8792bc0842e2d321afa978f2ae20d64cba;p=systemtap.git

Document some new features and improvements since systemtap 1.6.

task_backtrace removed, MAXBACKTRACE documented, new probe_type() function,
unwind and symbol data only processed when really necesessary, kernel
backtraces for non-pt_regs probe context (timer and tracepoints),
ubacktrace() from kernel probe points, s390x user space support, ppc,
s390x and arm dwarf unwinder support, arm uprobes port.
---

diff --git a/NEWS b/NEWS
index 5e1f5a402..170b66ef6 100644
--- a/NEWS
+++ b/NEWS
@@ -54,6 +54,42 @@
       process(string).function(number).inline
       process(string).library(string).function(number).inline
 
+- The task_backtrace() tapset function was deprecated in 1.6 and has been
+  removed in 1.7.
+
+- MAXBACKTRACE did work in earlier releases, but has now been documented
+  in the stap 1 manual page.
+
+- New tapset function probe_type(). Returns a short string describing
+  the low level probe handler type for the current probe point.
+
+- Both unwind and symbol data is now only collected and emitted for
+  scripts actually using backtracing or function/data symbols.
+  Tapset functions are marked with /* pragma:symbols */ or
+  /* pragma:unwind */ to indicate they need the specific data.
+
+- Kernel backtraces can now be generated for non-pt_regs probe context
+  if the kernel support dump_trace(). This enables backtraces from
+  certain timer probes and tracepoints.
+
+- ubacktrace() should now also work for some kernel probes on x86 which can
+  use the dwarf unwinder to recover the user registers to provide
+  more accurate user backtraces.
+
+- For s390x the systemtap runtime now properly splits kernel and user
+  addresses (which are in separate address spaces on that architecture)
+  which enable user space introspection.
+
+- ppc and s390x now supports user backtraces through the DWARF unwinder.
+
+- ppc now handles function descriptors as symbol names correctly.
+
+- arm support kernel backtraces through the DWARF unwinder.
+
+- arm now have a uprobes port which enables user probes. This still
+  requires some kernel patches (user_regsets and tracehook support for
+  arm).
+
 * What's new in version 1.6, 2011-07-25
 
 - Security fixes for CVE-2011-2503: read instead of mmap to load modules,