STAP-PREP(1) General Commands Manual STAP-PREP(1)NAME
stap-prep - prepare system for systemtap use
SYNOPSIS
stap-prep [ KERNEL_VERSION ]
DESCRIPTION
The stap-prep executable prepares the system for systemtap use by installing kernel headers, debug symbols and build tools that match the
currently running kernel or optionally the kernel version given by the user.
The exact behavior of stap-prep may be customized by the distribution maintainers. It might for example only give suggestions and not actu-
ally install the required packages if that is difficult to automate.
EXAMPLES
$ stap-prep
Please install linux-image-3.2.0-2-amd64-dbg
SEE ALSO stap(1)BUGS
Use the Bugzilla link of the project web page or our mailing list. http://sourceware.org/systemtap/,<systemtap@sourceware.org>.
STAP-PREP(1)
Check Out this Related Man Page
STAP(7) Miscellaneous Information Manual STAP(7)NAME
stappaths - systemtap configurable file paths
DESCRIPTION
This manual page was generated on 2014-06-09 for systemtap 2.4. The following section will list the main paths in systemtap that are
important to know and may be required to reference.
/usr/share/systemtap/tapset/
The directory for the standard probe-alias / function tapset library, unless overridden by the SYSTEMTAP_TAPSET environment variable
or the XDG_DATA_DIRS environment variable. These are described in the stapprobes(3stap), probe::*(3stap), and function::*(3stap)
manual pages.
/usr/share/systemtap/runtime/
The runtime sources, unless overridden by the SYSTEMTAP_RUNTIME environment variable.
/usr/bin/staprun
The auxiliary program supervising module loading, interaction, and unloading.
/usr/libexec/systemtap/stapio
The auxiliary program for module input and output handling.
/usr/include/sys/sdt.h
Location of the <sys/sdt.h> headers.
Kernel debuginfo Path: /usr/lib/debug/lib/modules/$(uname -r)/
The location of kernel debugging information when packaged into the kernel-debuginfo RPM, unless overridden by the SYSTEMTAP_DEBUG-
INFO_PATH environment variable. The default value for this variable is +:.debug:/usr/lib/debug:build. elfutils searches vmlinux in
this path and it interprets the path as a base directory of which various subdirectories will be searched for finding debuginfo for
the kernel, kernel modules, and user-space binaries. By default, systemtap will also look for vmlinux in these locations:
/boot/vmlinux-`uname -r`
/lib/modules/`uname -r`/vmlinux
/lib/modules/`uname -r`/vmlinux.debug
/lib/modules/`uname -r`/build/vmlinux
/lib/modules/`uname -r`/.debug/vmlinux.debug
/usr/lib/debug/lib/modules/`uname -r`/vmlinux.debug
/var/cache/abrt-di/usr/debug/lib/modules/`uname -r`/
/var/cache/abrt-di/usr/lib/debug/lib/modules/`uname -r`/vmlinux.debug
Corresponding source files are usually located under /usr/src/debug/. Further file information on user-space applications can be
determined per-basis using rpm -ql <package>-debuginfo. For supported user-space applications information please visit the systemtap
wiki.
$HOME/.systemtap
Systemtap data directory for cached systemtap files, unless overridden by the SYSTEMTAP_DIR environment variable.
/tmp/stapXXXXXX
Temporary directory for systemtap files, including translated C code and kernel object.
/lib/modules/VERSION/build
The location of kernel module building infrastructure.
/usr/share/doc/systemtap*/examples
Examples with greater detail can be found here. Each example comes with a .txt or .meta file explaining what the example, sample or
demo does and how it is ordinarily run.
$SYSTEMTAP_DIR/ssl/server
User's server-side SSL certificate database. If SYSTEMTAP_DIR is not set, the default is $HOME/.systemtap.
$SYSTEMTAP_DIR/ssl/client
User's private client-side SSL certificate database. If SYSTEMTAP_DIR is not set, the default is $HOME/.systemtap.
/etc/systemtap/ssl/client
Global client-side SSL certificate database.
/etc/systemtap/staprun/
staprun's trusted signer certificate database.
/etc/sysconfig/stap-server/
stap-server service global configuration file.
/etc/stap-server/conf.d/*.conf
stap-server service configuration files for default servers.
/var/run/stap-server/
stap-server service default location of status files for running servers.
/var/log/stap-server/log
stap-server service default log file.
FILES
/usr/share/systemtap/tapset
SEE ALSO stapprobes(3stap),
staprun(8),
stapvars(3stap),
stapex(3stap),
stap-server(8),
awk(1),
gdb(1)BUGS
Use the Bugzilla link of the project web page or our mailing list. http://sourceware.org/systemtap/,<systemtap@sourceware.org>.
Systemtap Team STAP(7)