GOLF(2gg)

📦 version 601.4.41, in ubuntu questing

💖 GOLF(2gg) — bestie edition 💖

okay so this is the Golf manual, section 2gg, from the Development crew ✨

✨ NAME ✨

error-handling — Golf documentation (error-handling)

🫶 DESCRIPTION 🫶

💀 WHEN YOUR PROGRAM ERRORS OUT 💀

so "erroring out" literally means a process that's handling a request has hit a difficulty it cannot handle, and it's gonna do one of two things:

  • Skip the rest of the request, and move on quickly to handle the next request without exiting. Most errors are like this, bestie — for example your program has attempted to access memory outside of what's allocated, or you have called report-error statement.
  • Stop and exit, and it may be automatically restarted if it's a service. For instance, the process could be out of memory, or the database is permanently down and connection cannot be re-established.
ngl, note that if your program is command-line, it will exit in any case since it handles a single request anyway. no survivors 💀

🧚 WHEN THERE IS A PROBLEM IN GOLF 🧚

If there is a fatal internal error (i.e. error in Golf code itself that cannot be handled), it will be caught by Golf, and the process will end. And if your process is started with mgrg, it may be automatically restarted. the way that it just picks itself back up 😭👑

📝 LOGGING THE ERROR 📝

Regardless of the type of error and regardless of whether the process exits or not, the error is logged, and the program stack with full source code lines (see gg for including debug information) will be written to backtrace file (use -e option of gg to obtain its location).

lowkey important: the program stack is logged only if debugging info is present (i.e. if installed from package you must install debugging package as well). no debug info, no stack, periodt.

You can see the list of last N errors (and the location of file containing backtrace for them) by using gg. for instance, to see the last 3 errors:

gg -e 3

slay. that's it, that's the whole vibe check 🌸

🌈 SEE ALSO 🌈

  • Error handling
  • db-error error-code error-handling report-error See all documentation

💜 that's a wrap, bestie! this page was served fresh on $DATE, version $VERSION, and it's GOLF(2gg) — go forth and handle your errors, main character 💅🎀

📦 where this page comes from