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 on 2017-04-25 for systemtap 3.2.  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 2017-04-25.  If you dis‐
       cover 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)