STAP

Section: Environments, Tables, and Troff Macros (7)
Updated: Systemtap Team
Index Return to Main Contents

NAME

stappaths - systemtap miscellaneous and paths

DESCRIPTION

This manual page was generated on 2012-10-04 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/libexec/systemtap/stapio/

The Systemtap module input and output handler.

sdt.h Path: /usr/include/include/sys/std.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.

/usr/etc/systemtap/ssl/client

Global client-side SSL certificate database.

/usr/etc/systemtap/staprun/

staprun[aq]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

BUGS

Use the Bugzilla link of the project web page or our mailing list. http://sourceware.org/systemtap/,<systemtap@sourceware.org>.