AuSetErrorHandler(3)

📦 version 1.9.4, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 AuSetErrorHandler(3) — the Library Functions Manual one, bestie 💖

okay so real talk, this is AuSetErrorHandler(3) from audiolib (the Network Audio System C Language Interface, you know the vibe) ✨ and lowkey it's the page about setting your fatal IO error handler. yes the Name section calls it AuSetIOErrorHandler because the manual is a little chaotic like that 🙈 but it's the same iconic function, promise.

🌸 NAME 🌸

AuSetIOErrorHandler — set handler for fatal IO errors

like. that's the whole job. she sets the handler. she handles the fatality. periodt 💅

✨ SYNOPSIS ✨

#include <audio/audiolib.h>

AuBool (*AuSetIOErrorHandler(server, handler))()
    AuServer *server;
    AuBool (*handler)(AuServer *);

look at that function pointer returning a function pointer. it's giving main character energy fr fr 👑

🎀 ARGUMENTS 🎀

  • server — the connection to the audio server. your lil link to the audio server, the whole situationship. 🫶
  • handler — the fatal error handler. and bestie, listen: pass NULL to reinstall the default fatal error handler. that's the "never mind, factory reset me" option and honestly valid. 💀

🦋 DESCRIPTION 🦋

AuSetIOErrorHandler sets the fatal I/O error handler and returns the previous error handler. so you're not just installing a new one, you're getting the old one handed back to you like a passed note in class. 📝

the error handler gets invoked if a system call error occurs — for example, when the connection to the server was lost. 😭 that's the scenario. that's the moment. your server said "it's not you it's me" and dipped.

⚠️ and this is the important part so pay attention: as this is assumed to be a fatal condition, the error handler routine should not return. like, at all. if the I/O error handler does return, the client process exits. no cap. so don't write a handler that just casually returns and expects to keep vibing, because the process will simply be gone. 💀💀

🌈 SEE ALSO 🌈

  • AuServerName
  • AuGetErrorDatabaseText
  • AuGetErrorText
  • AuSetErrorHandler
  • AuSynchronize

and also audiolib — the Network Audio System C Language Interface, the whole era. 🌟

mwah, that's the page!! 🎀✨ this one's from audiolib, version 1.9.4, dated as the audiolib - error handling page, and it lives at section 3 as AuSetErrorHandler(3). go forth and set your fatal error handler, bestie, and remember: she does not return. she exits. 💖🦋👑

📦 where this page comes from