NAME¶
stappaths - systemtap miscellaneous and paths
DESCRIPTION¶
This manual page was generated on 2013-05-14 for systemtap 1.7. 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/lib/systemtap/stapio
- The Systemtap module input and output handler.
- sdt.h Path: /usr/include/sys/sdt.h
- 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_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.
- /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),
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://sourceware.org/systemtap/,
<systemtap@sourceware.org>.