stappaths(7) — Linux manual page

NAME | DESCRIPTION | SEE ALSO | BUGS | COLOPHON

STAP(7)             Miscellaneous Information Manual             STAP(7)

NAME         top

       stappaths - systemtap configurable file paths

DESCRIPTION         top

       This manual page was generated for systemtap 5.1.  The following
       section will list the main paths in systemtap that are important
       to know and may be required to reference.

       /usr/local/share/systemtap/tapset/
              The directory for the standard probe-alias / function
              tapset library, unless overridden by the SYSTEMTAP_TAPSET
              environment variable or the XDG_DATA_DIRS environment
              variable.  These are described in the stapprobes(3stap),
              probe::*(3stap), and function::*(3stap) manual pages.

       /usr/local/share/systemtap/runtime/
              The runtime sources, unless overridden by the
              SYSTEMTAP_RUNTIME environment variable.

       /usr/local/bin/staprun
              The auxiliary program supervising module loading,
              interaction, and unloading.

       ${prefix}/etc/stap-exporter
              The default directory to search for *.stp files, for
              exporting to HTTP.

       ${exec_prefix}/libexec/systemtap/stapio
              The auxiliary program for module input and output
              handling.

       /usr/include/sys/sdt.h
              Location of the <sys/sdt.h> headers.

       Kernel debuginfo Path: /usr/lib/debug/lib/modules/$(uname -r)/
              The location of kernel debugging information when packaged
              into the kernel-debuginfo RPM, unless overridden by the
              SYSTEMTAP_DEBUGINFO_PATH environment variable.  The
              default value for this variable is
              +:.debug:/usr/lib/debug:build.  elfutils searches vmlinux
              in this path and it interprets the path as a base
              directory of which various subdirectories will be searched
              for finding debuginfo for the kernel, kernel modules, and
              user-space binaries.  By default, systemtap will also look
              for vmlinux in these locations:

              /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

              Corresponding source files are usually located under
              /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.

              With elfutils version >0.178, systemtap can automatically
              download debugging information from debuginfod servers.
              You can try it by setting an environment variable or two:
              export DEBUGINFOD_URLS=https://debuginfod.elfutils.org/
              export DEBUGINFOD_PROGRESS=1

       $HOME/.systemtap
              Systemtap data directory for cached systemtap files, un‐
              less overridden by the SYSTEMTAP_DIR environment variable.

       /tmp/stapXXXXXX
              Temporary directory for systemtap files, including trans‐
              lated C code and kernel object.

       /lib/modules/VERSION/build
              The location of kernel module building infrastructure.

       /usr/local/share/doc/systemtap*/examples
              Examples with greater detail can be found here. Each exam‐
              ple comes with a .txt or .meta file explaining what the
              example, sample or demo does and how it is ordinarily run.
              See also online at:
              https://sourceware.org/systemtap/examples/ 

       $SYSTEMTAP_DIR/ssl/server
              User's server-side SSL certificate database. If SYSTEM‐
              TAP_DIR is not set, the default is $HOME/.systemtap.

       $SYSTEMTAP_DIR/ssl/client
              User's private client-side SSL certificate database. If
              SYSTEMTAP_DIR is not set, the default is $HOME/.systemtap.

       ${prefix}/etc/systemtap/ssl/client
              Global client-side SSL certificate database.

       ${prefix}/etc/systemtap/staprun/
              staprun's trusted signer certificate database.

       ${prefix}/etc/sysconfig/stap-server
              stap-server service global configuration file.

       ${prefix}/etc/sysconfig/stap-exporter
              stap-exporter service global configuration file.

       ${prefix}/var/run/stap-server/
              stap-server service default location of status files for
              running servers.

       ${prefix}/var/log/stap-server/log
              stap-server service default log file.

SEE ALSO         top

       stapprobes(3stap),
       staprun(8),
       stapvars(3stap),
       stapex(3stap),
       stap-server(8),
       awk(1),
       gdb(1)
       http://sourceware.org/elfutils/Debuginfod.html 

BUGS         top

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

COLOPHON         top

       This page is part of the systemtap (a tracing and live-system
       analysis tool) project.  Information about the project can be
       found at ⟨https://sourceware.org/systemtap/⟩.  If you have a bug
       report for this manual page, send it to systemtap@sourceware.org.
       This page was obtained from the project's upstream Git repository
       ⟨git://sourceware.org/git/systemtap.git⟩ on 2024-06-14.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2024-06-13.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

                             Systemtap Team                      STAP(7)

Pages that refer to this page: dtrace(1)stap(1)stap-merge(1)stapex(3stap)stapvars(3stap)warning::debuginfo(7stap)warning::symbols(7stap)stapbpf(8)stap-exporter(8)stap-server(8)