NAME

       error::pass1 - systemtap pass-1 errors

DESCRIPTION

       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 changes.

GATHERING MORE INFORMATION

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

SEE ALSO

       stap(1),
       error::reporting(7stap)

                                                                                             ERROR::PASS1(7stap)