xenial (7) stappaths.7.gz

Provided by: systemtap-doc_2.9-2ubuntu2_all bug

NAME

       stappaths - systemtap configurable file paths

DESCRIPTION

       This manual page was generated on 2016-04-02 for systemtap 2.9.  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.  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 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)