stapvars(3stap) — Linux manual page


STAPVARS(3stap)                                              STAPVARS(3stap)

NAME         top

       stapvars - systemtap variables

DESCRIPTION         top

       The following sections enumerate the public variables provided by
       standard tapsets installed, (the installation path is show in the
       stappaths (7) manual page).  Each variable is described with a type,
       and its behavior/restrictions.  The syntax is the same as printed
       with the stap option -p2.  Examples:

              Variable "example1" contains an integer.

       example2:string [long]
              Variable "example2" is an array of strings, indexed by

              Contains the value of the  $# value: the number of command
              line arguments passed to the systemtap script.  It is
              initialized with an implicit begin(-1) probe.

       argv:string [long]
              Contains each command line argument as a string.  argv[1] will
              equal @1 if there was at least one command line argument.
              Arguments beyond #32 are not transcribed, and produce a
              warning message within the begin(-1) probe that initializes
              this array.

              Simply defined as the number 0.

FILES         top

       More files and their corresponding paths can be found in the
       stappaths (7) manual page.

SEE ALSO         top


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 ⟨⟩.  If you have a bug report for
       this manual page, send it to  This page was
       obtained from the project's upstream Git repository
       ⟨git://⟩ on 2020-09-18.  (At that
       time, the date of the most recent commit that was found in the repos‐
       itory was 2020-09-18.)  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


Pages that refer to this page: stap(1)stap-merge(1)stappaths(7)