NAME
stappaths - systemtap miscellaneous and paths
DESCRIPTION
This manual page was generated on 2011-01-24 for systemtap 1.4. The
following section will list the main paths in systemtap that are
important to know and may be required to reference.
Tapset Path: /usr/share/systemtap/tapset/
Systemtap data directory for cached systemtap files, unless
overridden by the SYSTEMTAP_TAPSET environment variable or the
XDG_DATA_DIRS environment variable. This directory stores a set
of builtin functions and probe point aliases are provided by the
scripts installed here. These are described in the
stapfuncs(3stap) and stapprobes(3stap) manual pages.
Runtime Path: /usr/share/systemtap/runtime/
The runtime sources, unless overridden by the SYSTEMTAP_RUNTIME
environment variable.
Staprun Path: /usr/bin/staprun/
The auxiliary program supervising module loading, interaction,
and unloading.
Stapio Path: /usr/libexec/systemtap/stapio/
The Systemtap module input and output handler.
sdt.h Path: /usr/include/include/sys/std.h
Debuginfo Path: /usr/lib/debug/lib/modules/Kernel-Debuginfo-Version/
The location of kernel debugging information when packaged into
the kernel-debuginfo RPM, unless overridden by the
SYSTEMTAP_DEBUGINFO_PATH environment variable. The default
value for this variable is +:.debug:/usr/lib/debug:build and can
be changed using $env SYSTEMTAP_DEBUGINFO_PATH=/path/to/vmlinux
. Elfutils searches vmlinux in this path and it interprets the
path as a base directory of which various subdirectories will be
searched for finding modules. 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
Debuginfo for user-space applications have source files located
in /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.
/usr/etc/systemtap/ssl/client
Global client-side SSL certificate database.
/usr/etc/systemtap/staprun/
staprun's trusted signer certificate database.
/usr/etc/sysconfig/stap-server/
stap-server service global configuration file.
/usr/etc/stap-server/conf.d/*.conf
stap-server service configuration files for default servers.
/usr/var/run/stap-server/
stap-server service default location of status files for running
servers.
/usr/var/log/stap-server.log
stap-server service default log file.
FILES
/usr/share/systemtap/tapset
SEE ALSO
stapprobes(3stap), stapfuncs(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://sources.redhat.com/systemtap/,<systemtap@sources.redhat.com>.
Systemtap Team STAP(7)