stappaths(7)

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.8.  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::*[24m(3stap),  and  func‐
21              tion::*[24m(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