summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--NEWS5
-rw-r--r--stap.1.in9
2 files changed, 14 insertions, 0 deletions
diff --git a/NEWS b/NEWS
index 2a713ba6..8ec00f2b 100644
--- a/NEWS
+++ b/NEWS
@@ -1,5 +1,10 @@
* What's new
+- @cast can now determine its type information using an explicit header
+ specification. For example:
+ @cast(tv, "timeval", "<sys/time.h>")->tv_sec
+ @cast(task, "task_struct", "kernel<linux/sched.h>")->tgid
+
- The overlapping process.* tapsets are now separated. Those probe points
documented in stapprobes(3stap) remain the same. Those that were formerly
in stapprobes.process(3stap) have been renamed to kprocess, to reflect
diff --git a/stap.1.in b/stap.1.in
index a5a8ab84..82a62b6d 100644
--- a/stap.1.in
+++ b/stap.1.in
@@ -800,6 +800,15 @@ separators. If the module is not specified, it will default either to
the probe module for dwarf probes, or to "kernel" for functions and all
other probes types.
.PP
+The translator can create its own module with type information from a header
+surrounded by angle brackets, in case normal debuginfo is not available. For
+kernel headers, prefix it with "kernel" to use the appropriate build system.
+All other headers are build with default GCC parameters into a user module.
+.SAMPLE
+@cast(tv, "timeval", "<sys/time.h>")->tv_sec
+@cast(task, "task_struct", "kernel<linux/sched.h>")->tgid
+.ESAMPLE
+.PP
When in guru mode, the translator will also allow scripts to assign new
values to members of typecasted pointers.
.PP