ERROR::PASS1(7stap)                                      ERROR::PASS1(7stap)

NAME         top

       error::pass1 - systemtap pass-1 errors

DESCRIPTION         top

       Errors that occur during pass 1 (parsing) usually mean a basic syntax
       error of some sort occurred in the systemtap script.  There are
       several classes of problems possible:

       plain syntax error
              The systemtap script parser detects a large variety of errors,
              such as missing operands, bad punctuation.  It tries to list
              what kinds of tokens it was expecting to see, and will show
              the region of the source code with the problem.  Please review
              the stap(1) man page and/or the tutorial, to correct the
              script's syntax.

       grammar ambiguities
              There is at least one known ambiguity in the systemtap
              grammar.  It relates to the optionality of ; (semicolon)
              separators between statements, and the ++ and --
              increment/decrement operators.  If the parser indicates an
              error, consider adding some explicit ; separators between
              nearby statements and try again.

       missing command line arguments
              A systemtap script that uses the $N and @N constructs for
              substituting in command-line options may fail if not enough
              options were given on the stap command line.

       compatibility changes
              Some versions of systemtap have changed the language
              incompatibly, for example by adding the try/catch keywords for
              exception handling.  In such cases, rerun systemtap with the
              --compatibility=VERSION option, substituting the last
              systemtap version where your script was known to work.  You
              may also check the release-history NEWS file for compatibility


       Increasing the verbosity of pass-1 with an option such as --vp 1 can
       help pinpoint the problem.

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 2019-11-19.  (At that
       time, the date of the most recent commit that was found in the repos‐
       itory was 2019-11-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