trusty (7) stappaths.7.gz

Provided by: systemtap-doc_2.3-1ubuntu1.4_all bug

NAME

       stappaths - systemtap configurable file paths

DESCRIPTION

       This manual page was generated on 2016-03-16 for systemtap 2.3.  The following section will list the main
       paths in systemtap that are important to know and may be required to reference.

       /usr/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/share/systemtap/runtime/
              The runtime sources, unless overridden by the SYSTEMTAP_RUNTIME environment variable.

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

       /usr/lib/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.

       $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/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.

       $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 SYSTEMTAP_DIR is not set, the  default  is
              $HOME/.systemtap.

       /etc/systemtap/ssl/client
              Global client-side SSL certificate database.

       /etc/systemtap/staprun/
              staprun's trusted signer certificate database.

       /etc/sysconfig/stap-server/
              stap-server service global configuration file.

       /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 running servers.

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

FILES

       /usr/share/systemtap/tapset

SEE ALSO

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

BUGS

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

                                                 Systemtap Team                                          STAP(7)