2 .TH STAP 7 "Systemtap Team"
5 stappaths \- systemtap miscellaneous and paths
21 This manual page was generated on @DATE@ for systemtap @VERSION@.
22 The following section will list the main paths in systemtap that are
23 important to know and may be required to reference.
25 Tapset Path: @prefix@/share/systemtap/tapset/
26 Systemtap data directory for cached systemtap files, unless overridden
29 environment variable or the
32 This directory stores a set of builtin functions and probe point
33 aliases are provided by the scripts installed here.
34 These are described in the
35 .IR stapfuncs "(3stap) and " stapprobes (3stap)
38 Runtime Path: @prefix@/share/systemtap/runtime/
39 The runtime sources, unless overridden by the
43 Staprun Path: @prefix@/bin/staprun
44 The auxiliary program supervising module loading, interaction, and
47 Stapio Path: @libexecdir@/systemtap/stapio
48 The Systemtap module input and output handler.
50 sdt.h Path: @oldincludedir@/sys/sdt.h
52 Kernel debuginfo Path: /usr/lib/debug/lib/modules/$(uname \-r)/
53 The location of kernel debugging information when packaged into the
55 RPM, unless overridden by the
56 .I SYSTEMTAP_DEBUGINFO_PATH
57 environment variable. The default value for this variable is
58 .I \+:.debug:/usr/lib/debug:build
59 and can be changed using $env SYSTEMTAP_DEBUGINFO_PATH=/path/to/vmlinux .
60 Elfutils searches vmlinux in this path and it interprets the path as a base
61 directory of which various subdirectories will be searched for finding modules.
62 By default, systemtap will also look for vmlinux in these locations:
65 /boot/vmlinux\-`uname \-r`
66 /lib/modules/`uname \-r`/vmlinux
67 /lib/modules/`uname \-r`/vmlinux.debug
68 /lib/modules/`uname \-r`/build/vmlinux
69 /lib/modules/`uname \-r`/.debug/vmlinux.debug
70 /usr/lib/debug/lib/modules/`uname \-r`/vmlinux.debug
71 /var/cache/abrt\-di/usr/debug/lib/modules/`uname \-r`/
72 /var/cache/abrt\-di/usr/lib/debug/lib/modules/`uname \-r`/vmlinux.debug
77 Debuginfo for user-space applications have source files located in /usr/src/debug/
78 Further file information on user-space applications can be determined per-basis using
79 rpm \-ql <package>\-debuginfo. For supported user-space applications information please
80 visit the systemtap wiki.
83 Systemtap data directory for cached systemtap files, unless overridden
89 Temporary directory for systemtap files, including translated C code
92 /lib/modules/VERSION/build
93 The location of kernel module building infrastructure.
95 @prefix@/share/doc/systemtap*/examples
96 Examples with greater detail, can be found here. Each example comes with a .txt
97 or .meta file explaining what the example, sample or demo does and how it is
100 $SYSTEMTAP_DIR/ssl/server
101 User's server\-side SSL certificate database. If SYSTEMTAP_DIR is not
102 set, the default is $HOME/.systemtap.
104 $SYSTEMTAP_DIR/ssl/client
105 User's private client\-side SSL certificate database. If SYSTEMTAP_DIR is not
106 set, the default is $HOME/.systemtap.
108 @sysconfdir@/systemtap/ssl/client
109 Global client\-side SSL certificate database.
111 @sysconfdir@/systemtap/staprun/
112 \fIstaprun\fR\[aq]s trusted signer certificate database.
114 @sysconfdir@/sysconfig/stap\-server/
115 stap\-server service global configuration file.
117 @sysconfdir@/stap\-server/conf.d/*.conf
118 stap\-server service configuration files for default servers.
120 /var/run/stap\-server/
121 stap\-server service default location of status files for running servers.
123 /var/log/stap\-server/log
124 stap\-server service default log file.
130 .IR @prefix@/share/systemtap/tapset
134 .IR stapprobes (3stap),
135 .IR stapfuncs (3stap),
137 .IR stapvars (3stap),
139 .IR stap\-server (8),
145 Use the Bugzilla link of the project web page or our mailing list.
147 .BR http://sourceware.org/systemtap/ , <systemtap@sourceware.org> .