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

NAME

6       stappaths - systemtap configurable file paths
7
8
9
10

DESCRIPTION

12       This  manual  page was generated for systemtap 4.7.  The following sec‐
13       tion will list the main paths in systemtap that are important  to  know
14       and may be required to reference.
15
16       /usr/share/systemtap/tapset/
17              The directory for the standard probe-alias / function tapset li‐
18              brary, unless overridden  by  the  SYSTEMTAP_TAPSET  environment
19              variable  or  the XDG_DATA_DIRS environment variable.  These are
20              described in the stapprobes(3stap), probe::*(3stap),  and  func‐
21              tion::*(3stap) manual pages.
22
23       /usr/share/systemtap/runtime/
24              The  runtime sources, unless overridden by the SYSTEMTAP_RUNTIME
25              environment variable.
26
27       /usr/bin/staprun
28              The auxiliary program supervising module  loading,  interaction,
29              and unloading.
30
31       /etc/stap-exporter
32              The  default  directory to search for *.stp files, for exporting
33              to HTTP.
34
35       /usr/libexec/systemtap/stapio
36              The auxiliary program for module input and output handling.
37
38       /usr/include/sys/sdt.h
39              Location of the <sys/sdt.h> headers.
40
41       Kernel debuginfo Path: /usr/lib/debug/lib/modules/$(uname -r)/
42              The location of kernel debugging information when packaged  into
43              the kernel-debuginfo RPM, unless overridden by the SYSTEMTAP_DE‐
44              BUGINFO_PATH environment variable.  The default value  for  this
45              variable  is  +:.debug:/usr/lib/debug:build.   elfutils searches
46              vmlinux in this path and it interprets the path as a base direc‐
47              tory  of which various subdirectories will be searched for find‐
48              ing debuginfo for the kernel, kernel modules, and user-space bi‐
49              naries.   By  default,  systemtap  will also look for vmlinux in
50              these locations:
51
52              /boot/vmlinux-`uname -r`
53              /lib/modules/`uname -r`/vmlinux
54              /lib/modules/`uname -r`/vmlinux.debug
55              /lib/modules/`uname -r`/build/vmlinux
56              /lib/modules/`uname -r`/.debug/vmlinux.debug
57              /usr/lib/debug/lib/modules/`uname -r`/vmlinux.debug
58              /var/cache/abrt-di/usr/debug/lib/modules/`uname -r`/
59              /var/cache/abrt-di/usr/lib/debug/lib/modules/`uname -r`/vmlinux.debug
60
61              Corresponding   source   files   are   usually   located   under
62              /usr/src/debug/.   Further file information on user-space appli‐
63              cations can be determined per-basis using rpm -ql  <package>-de‐
64              buginfo.   For  supported  user-space  applications  information
65              please visit the systemtap wiki.
66
67              With elfutils version >0.178, systemtap can automatically  down‐
68              load debugging information from debuginfod servers.  You can try
69              it by setting an environment variable or two:
70              export DEBUGINFOD_URLS=https://debuginfod.elfutils.org/
71              export DEBUGINFOD_PROGRESS=1
72
73
74       $HOME/.systemtap
75              Systemtap data directory  for  cached  systemtap  files,  unless
76              overridden by the SYSTEMTAP_DIR environment variable.
77
78       /tmp/stapXXXXXX
79              Temporary  directory for systemtap files, including translated C
80              code and kernel object.
81
82       /lib/modules/VERSION/build
83              The location of kernel module building infrastructure.
84
85       /usr/share/doc/systemtap*/examples
86              Examples with greater detail can be  found  here.  Each  example
87              comes  with  a  .txt  or .meta file explaining what the example,
88              sample or demo does and how it is ordinarily run.  See also  on‐
89              line at: https://sourceware.org/systemtap/examples/
90
91       $SYSTEMTAP_DIR/ssl/server
92              User's server-side SSL certificate database. If SYSTEMTAP_DIR is
93              not set, the default is $HOME/.systemtap.
94
95       $SYSTEMTAP_DIR/ssl/client
96              User's private client-side SSL certificate database. If  SYSTEM‐
97              TAP_DIR is not set, the default is $HOME/.systemtap.
98
99       /etc/systemtap/ssl/client
100              Global client-side SSL certificate database.
101
102       /etc/systemtap/staprun/
103              staprun's trusted signer certificate database.
104
105       /etc/sysconfig/stap-server
106              stap-server service global configuration file.
107
108       /etc/sysconfig/stap-exporter
109              stap-exporter service global configuration file.
110
111       /var/run/stap-server/
112              stap-server service default location of status files for running
113              servers.
114
115       /var/log/stap-server/log
116              stap-server service default log file.
117
118

SEE ALSO

120       stapprobes(3stap),
121       staprun(8),
122       stapvars(3stap),
123       stapex(3stap),
124       stap-server(8),
125       awk(1),
126       gdb(1)
127       http://sourceware.org/elfutils/Debuginfod.html
128
129

BUGS

131       Use the Bugzilla link of the project web  page  or  our  mailing  list.
132       http://sourceware.org/systemtap/,<systemtap@sourceware.org>.
133
134
135
136                                Systemtap Team                         STAP(7)
Impressum