From cff7feda3e990bb554f39dbf5d8055256dca5af5 Mon Sep 17 00:00:00 2001 From: Josh Stone Date: Tue, 21 Apr 2009 12:34:33 -0700 Subject: Document @cast-with-headers --- NEWS | 5 +++++ stap.1.in | 9 +++++++++ 2 files changed, 14 insertions(+) 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", "")->tv_sec + @cast(task, "task_struct", "kernel")->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", "")->tv_sec +@cast(task, "task_struct", "kernel")->tgid +.ESAMPLE +.PP When in guru mode, the translator will also allow scripts to assign new values to members of typecasted pointers. .PP -- cgit