/usr/share/systemtap/tapset/linux/context-unwind.stp is in systemtap-common 2.3-1ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 | // context-unwind tapset
// Copyright (C) 2005-2013 Red Hat Inc.
// Copyright (C) 2006 Intel Corporation.
//
// This file is part of systemtap, and is free software. You can
// redistribute it and/or modify it under the terms of the GNU General
// Public License (GPL); either version 2, or (at your option) any
// later version.
// <tapsetdescription>
// Context functions provide additional information about where an event occurred. These functions can
//provide information such as a backtrace to where the event occurred and the current register values for the
//processor.
// </tapsetdescription>
/**
* sfunction print_backtrace - Print kernel stack back trace
*
* Description: This function is equivalent to print_stack(backtrace()),
* except that deeper stack nesting may be supported. See print_ubacktrace
* for user-space backtrace.
* The function does not return a value.
*/
function print_backtrace () %{
/* pragma:unwind */ /* pragma:symbols */
_stp_stack_kernel_print(CONTEXT, _STP_SYM_FULL);
%}
/**
* sfunction sprint_backtrace - Return stack back trace as string
*
* Returns a simple (kernel) backtrace. One line per address.
* Includes the symbol name (or hex address if symbol
* couldn't be resolved) and module name (if found). Includes the
* offset from the start of the function if found, otherwise the
* offset will be added to the module (if found, between
* brackets). Returns the backtrace as string (each line terminated by
* a newline character). Note that the returned stack will be
* truncated to MAXSTRINGLEN, to print fuller and richer stacks use
* print_backtrace(). Equivalent to sprint_stack(backtrace()),
* but more efficient (no need to translate between hex strings and
* final backtrace string).
*/
function sprint_backtrace:string () %{
/* pure */ /* pragma:unwind */ /* pragma:symbols */
_stp_stack_kernel_sprint (STAP_RETVALUE, MAXSTRINGLEN,
CONTEXT, _STP_SYM_SIMPLE);
%}
/**
* sfunction backtrace - Hex backtrace of current kernel stack
*
* Description: This function returns a string of hex addresses
* that are a backtrace of the kernel stack. Output may be truncated
* as per maximum string length (MAXSTRINGLEN). See
* ubacktrace() for user-space backtrace.
*/
function backtrace:string () %{ /* pure */ /* pragma:unwind */
_stp_stack_kernel_sprint (STAP_RETVALUE, MAXSTRINGLEN,
CONTEXT, _STP_SYM_NONE);
%}
%( systemtap_v <= "1.6" %?
/**
* sfunction task_backtrace - Hex backtrace of an arbitrary task
* @task: pointer to task_struct
*
* Description: This function returns a string of hex addresses
* that are a backtrace of the stack of a particular task
* Output may be truncated as per maximum string length.
* Deprecated in SystemTap 1.6.
*/
function task_backtrace:string (task:long) {
warn("task_backtrace unsupported")
}
%)
|