1STAP(7)                Miscellaneous Information Manual                STAP(7)
2
3
4

NAME

6       stappaths - systemtap miscellaneous and paths
7
8
9
10

DESCRIPTION

12       This  manual  page  was generated on 2011-08-02 for systemtap 1.6.  The
13       following section will list the main paths in systemtap that are impor‐
14       tant to know and may be required to reference.
15
16       Tapset Path: /usr/share/systemtap/tapset/
17              Systemtap  data  directory  for  cached  systemtap files, unless
18              overridden by the SYSTEMTAP_TAPSET environment variable  or  the
19              XDG_DATA_DIRS environment variable.  This directory stores a set
20              of builtin functions and probe point aliases are provided by the
21              scripts  installed  here.   These  are  described  in  the stap‐
22              funcs(3stap) and stapprobes(3stap) manual pages.
23
24       Runtime Path: /usr/share/systemtap/runtime/
25              The runtime sources, unless overridden by the  SYSTEMTAP_RUNTIME
26              environment variable.
27
28       Staprun Path: /usr/bin/staprun/
29              The  auxiliary  program supervising module loading, interaction,
30              and unloading.
31
32       Stapio Path: /usr/libexec/systemtap/stapio/
33              The Systemtap module input and output handler.
34
35       sdt.h Path: /usr/include/include/sys/std.h
36
37       Debuginfo Path: /usr/lib/debug/lib/modules/Kernel-Debuginfo-Version/
38              The location of kernel debugging information when packaged  into
39              the  kernel-debuginfo  RPM,  unless  overridden  by  the SYSTEM‐
40              TAP_DEBUGINFO_PATH environment variable.  The default value  for
41              this   variable  is  +:.debug:/usr/lib/debug:build  and  can  be
42              changed using $env  SYSTEMTAP_DEBUGINFO_PATH=/path/to/vmlinux  .
43              Elfutils  searches  vmlinux  in  this path and it interprets the
44              path as a base directory of which various subdirectories will be
45              searched  for  finding modules.  By default, systemtap will also
46              look for vmlinux in these locations:
47
48              /boot/vmlinux-`uname -r`
49              /lib/modules/`uname -r`/vmlinux
50              /lib/modules/`uname -r`/vmlinux.debug
51              /lib/modules/`uname -r`/build/vmlinux
52              /lib/modules/`uname -r`/.debug/vmlinux.debug
53              /usr/lib/debug/lib/modules/`uname -r`/vmlinux.debug
54              /var/cache/abrt-di/usr/debug/lib/modules/`uname -r`/
55              /var/cache/abrt-di/usr/lib/debug/lib/modules/`uname -r`/vmlinux.debug
56
57              Debuginfo for user-space applications have source files  located
58              in /usr/src/debug/ Further file information on user-space appli‐
59              cations can be determined per-basis using rpm -ql  <package>-de‐
60              buginfo.   For  supported  user-space  applications  information
61              please visit the systemtap wiki.
62
63       $HOME/.systemtap
64              Systemtap data directory  for  cached  systemtap  files,  unless
65              overridden by the SYSTEMTAP_DIR environment variable.
66
67       /tmp/stapXXXXXX
68              Temporary  directory for systemtap files, including translated C
69              code and kernel object.
70
71       /lib/modules/VERSION/build
72              The location of kernel module building infrastructure.
73
74       /usr/share/doc/systemtap*/examples
75              Examples with greater detail, can be found  here.  Each  example
76              comes  with  a  .txt  or .meta file explaining what the example,
77              sample or demo does and how it is ordinarily run.
78
79       $SYSTEMTAP_DIR/ssl/server
80              User's server-side SSL certificate database. If SYSTEMTAP_DIR is
81              not set, the default is $HOME/.systemtap.
82
83       $SYSTEMTAP_DIR/ssl/client
84              User's  private client-side SSL certificate database. If SYSTEM‐
85              TAP_DIR is not set, the default is $HOME/.systemtap.
86
87       /usr/etc/systemtap/ssl/client
88              Global client-side SSL certificate database.
89
90       /usr/etc/systemtap/staprun/
91              staprun's trusted signer certificate database.
92
93       /usr/etc/sysconfig/stap-server/
94              stap-server service global configuration file.
95
96       /usr/etc/stap-server/conf.d/*.conf
97              stap-server service configuration files for default servers.
98
99       /usr/var/run/stap-server/
100              stap-server service default location of status files for running
101              servers.
102
103       /usr/var/log/stap-server.log
104              stap-server service default log file.
105
106
107

FILES

109       /usr/share/systemtap/tapset
110
111

SEE ALSO

113       stapprobes(3stap),   stapfuncs(3stap),   staprun(8),   stapvars(3stap),
114       stapex(3stap), stap-server(8), awk(1), gdb(1)
115
116
117

BUGS

119       Use the Bugzilla link of the project web  page  or  our  mailing  list.
120       http://sourceware.org/systemtap/,<systemtap@sourceware.org>.
121
122
123
124                                Systemtap Team                         STAP(7)
Impressum