.\" -*- nroff -*-
.TH STAP 7  "Systemtap Team"
.SH NAME

stappaths \- systemtap miscellaneous and paths


.\" macros
.de SAMPLE
.br
.RS
.nf
..
.de ESAMPLE
.hy
.fi
.RE
..

.SH 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.
.TP
Tapset Path: /usr/share/systemtap/tapset/
Systemtap data directory for cached systemtap files, unless overridden
by the
.I SYSTEMTAP_TAPSET
environment variable or the
.I 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
.IR stapfuncs "(3stap) and " stapprobes (3stap)
manual pages.
.TP
Runtime Path: /usr/share/systemtap/runtime/
The runtime sources, unless overridden by the
.I SYSTEMTAP_RUNTIME
environment variable.
.TP
Staprun Path: /usr/bin/staprun
The auxiliary program supervising module loading, interaction, and
unloading.
.TP
Stapio Path: /usr/lib/systemtap/stapio
The Systemtap module input and output handler.
.TP
sdt.h Path: /usr/include/sys/sdt.h
.TP
Kernel debuginfo Path: /usr/lib/debug/lib/modules/$(uname \-r)/
The location of kernel debugging information when packaged into the
.IR kernel\-debuginfo
RPM, unless overridden by the
.I SYSTEMTAP_DEBUGINFO_PATH
environment variable.  The default value for this variable is
.I \+:.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:

.SAMPLE
/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
.PP
.ESAMPLE
.IP
      
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. 
.TP
$HOME/.systemtap
Systemtap data directory for cached systemtap files, unless overridden
by the
.I SYSTEMTAP_DIR
environment variable.
.TP
/tmp/stapXXXXXX
Temporary directory for systemtap files, including translated C code
and kernel object.
.TP
/lib/modules/VERSION/build
The location of kernel module building infrastructure.
.TP
/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.
.TP
$SYSTEMTAP_DIR/ssl/server
User's server\-side SSL certificate database. If SYSTEMTAP_DIR is not
set, the default is $HOME/.systemtap.
.TP
$SYSTEMTAP_DIR/ssl/client
User's private client\-side SSL certificate database. If SYSTEMTAP_DIR is not
set, the default is $HOME/.systemtap.
.TP
/etc/systemtap/ssl/client
Global client\-side SSL certificate database.
.TP
/etc/systemtap/staprun/
\fIstaprun\fR\[aq]s trusted signer certificate database.
.TP
/etc/sysconfig/stap\-server/
stap\-server service global configuration file.
.TP
/etc/stap\-server/conf.d/*.conf
stap\-server service configuration files for default servers.
.TP
/var/run/stap\-server/
stap\-server service default location of status files for running servers.
.TP
/var/log/stap\-server/log
stap\-server service default log file.


.PP
.SH FILES
.nh
.IR /usr/share/systemtap/tapset
.hy

.SH SEE ALSO
.IR stapprobes (3stap),
.IR stapfuncs (3stap),
.IR staprun (8),
.IR stapvars (3stap),
.IR stapex (3stap),
.IR stap\-server (8),
.IR awk (1),
.IR gdb (1)


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