NAME | DESCRIPTION | FILES | 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 3.3.  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.

       ${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 ap‐
              plications can be determined per-basis using rpm -ql <pack‐
              age>-debuginfo. For supported user-space applications informa‐
              tion please visit the systemtap wiki.

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

       /tmp/stapXXXXXX
              Temporary directory for systemtap files, including translated
              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 example
              comes with a .txt or .meta file explaining what the example,
              sample or demo does and how it is ordinarily run.  See also
              http://sourceware.org/systemtap/examples/ 

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

       $SYSTEMTAP_DIR/ssl/client
              User's private client-side SSL certificate database. If SYS‐
              TEMTAP_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/stap-server/conf.d/*.conf
              stap-server service configuration files for default servers.

       /var/run/stap-server/
              stap-server service default location of status files for run‐
              ning servers.

       /var/log/stap-server/log
              stap-server service default log file.

FILES         top

       /usr/local/share/systemtap/tapset

SEE ALSO         top

       stapprobes(3stap),
       staprun(8),
       stapvars(3stap),
       stapex(3stap),
       stap-server(8),
       awk(1),
       gdb(1)

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 2018-04-30.  (At that
       time, the date of the most recent commit that was found in the repos‐
       itory was 2018-04-27.)  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)stap-server(8)