diff options
| author | fche <fche> | 2006-05-12 17:50:35 +0000 |
|---|---|---|
| committer | fche <fche> | 2006-05-12 17:50:35 +0000 |
| commit | 8b181aa4a0ae696d349b45a45e584ea527e8e26b (patch) | |
| tree | 9b79858ee0348f5830aa97015f2342bb93580808 | |
| parent | 17926083bb5a1538bf41951d15e23d0e9027d4ef (diff) | |
| download | systemtap-steved-8b181aa4a0ae696d349b45a45e584ea527e8e26b.tar.gz systemtap-steved-8b181aa4a0ae696d349b45a45e584ea527e8e26b.tar.xz systemtap-steved-8b181aa4a0ae696d349b45a45e584ea527e8e26b.zip | |
2006-05-12 Frank Ch. Eigler <fche@elastic.org>
* stapfuncs.5.in: Clarify backtrace-related functions.
| -rw-r--r-- | ChangeLog | 4 | ||||
| -rw-r--r-- | stapfuncs.5.in | 19 |
2 files changed, 17 insertions, 6 deletions
@@ -1,3 +1,7 @@ +2006-05-12 Frank Ch. Eigler <fche@elastic.org> + + * stapfuncs.5.in: Clarify backtrace-related functions. + 2006-05-11 David Smith <dsmith@redhat.com> * tapset/ctime.stp: New file. diff --git a/stapfuncs.5.in b/stapfuncs.5.in index 0bfac1b8..2d3d0678 100644 --- a/stapfuncs.5.in +++ b/stapfuncs.5.in @@ -141,15 +141,22 @@ Return the effective gid of the current process. print_regs:unknown () Print a register dump. .TP -print_backtrace:unknown () -Print a symbolic backtrace. Use with care. May be timeconsuming. -.TP backtrace:string () Return a string of hex addresses that are a backtrace of the stack. -May be truncated due to maximum string length. +It may be truncated due to maximum string length. .TP -print_stack (bt:string) -Perform a symbolic lookup of the addresses in bt and prints one per line. +print_stack:unknown (bt:string) +Perform a symbolic lookup of the addresses in the given string, +which is assumed to be the result of a prior call to +.IR backtrace() . +Print one line per address, including the address, the name of the +function containing the address, and an estimate of its position +within that function. Return nothing. +.TP +print_backtrace:unknown () +Equivalent to +.IR print_stack(backtrace()) , +except that deeper stack nesting may be supported. Return nothing. .TP pp:string () Return the probe point associated with the currently running probe handler, |