stappaths(1)
systemtap configurable file paths
DESCRIPTION
This manual page was generated on 2016-06-16 for systemtap 3.0.
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/lib/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_DEBUGINFO_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. See also
http://sourceware.org/systemtap/examples/
- $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