ERROR::PASS1(7stap)

💖 error::pass1 — a 7stap moment 💖

okay bestie, welcome to the error::pass1 page of the systemtap manual, section 7stap. this is the part where we talk about pass-1 errors, and honestly? they're the "you typed it wrong, babe" of the systemtap world. let's get into it 🫶

✨ NAME ✨

error::pass1 — systemtap pass-1 errors 💅

🌸 DESCRIPTION 🌸

so like, errors that happen during pass 1 (that's the parsing stage) usually mean some basic syntax error happened in your systemtap script. it's giving "you wrote a word and the computer said no." there are several classes of problems possible, and here they are, one by one, no skips 🎀

• plain syntax error — the systemtap script parser catches a huge variety of errors, like missing operands or bad punctuation. it tries to list what kinds of tokens it was expecting to see, and it'll show you the region of the source code with the problem. so please go review the stap(1) man page and/or the tutorial, and fix the script's syntax. the parser is literally handing you the receipt 🧾
• 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. so if the parser indicates an error, consider adding some explicit ; separators between nearby statements and try again. sometimes the vibe is just "semicolon, bestie" 💀
• 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. so like, feed the script its little snacks 🍓
• 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. she's not broken, she's just on a different era ✨

🔍 GATHERING MORE INFORMATION 🔍

increasing the verbosity of pass-1 with an option such as --vp 1 can help pinpoint the problem. more words = more clues, and we love clues 💜

👑 SEE ALSO 👑

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

and that's the whole page, bestie!! 🦋 this was ERROR::PASS1(7stap) — the systemtap error::pass1 manual page, section 7stap, and yeah, the footer is just the page name again being its own main character. go fix those syntax errors, you absolute icon 💖🎀⭐