AuErrorEvent(3)

✨ AuErrorEvent — the error event structure bestie ✨

okay so this is a page from the audiolib manual, section 3 (library functions), and it's all about AuErrorEvent. it's giving "something went wrong but like, not fatally". let's get into it 💅

---

🎀 NAME 🎀

AuErrorEvent — the error event structure. that's it. that's the whole name. no cap.

---

🌸 STRUCTURES 🌸

first up, you gotta know that AuErrorEvent lives inside the big AuEvent union. here's the vibe:

#include <audio/audiolib.h>

typedef union _AuEvent
{
    . . .
    AuErrorEvent auerror;
    . . .
}AuEvent;

and here's the struct itself, in all its glory:

typedef struct _AuErrorEvent
{
    int type;
    AuUint32 serial;
    AuBool send_event;
    AuServer *server;
    AuTime time;
    AuID resourceid;
    unsigned char error_code;
    unsigned char request_code;
    unsigned char minor_code;
    union
    {
        AuUint32 l[4];
    }data;
}AuErrorEvent;

like, look at her. iconic. 👑

---

💖 MEMBERS 💖

okay bestie, member-by-member breakdown, no skips, we're doing all of them:

• type — the event type, and for error events it's literally type 0. zero. the origin story.
• serial — the serial number of the failed request. yes, the request that said "nope".
• send_event — AuTrue if this event came from a SendEvent protocol request. otherwise it didn't, obviously. 💅
• server — the connection to the audio server that the event was read from. your server. your girl.
• time — the server time in milliseconds when the event was generated. millisecond precision, we love to see it.
• resourceid — the resource ID (or other value) of the failed request.
• error_code — the error code of the failed request. the receipts, basically.
• request_code — the protocol major request code of the failed request.
• minor_code — the protocol minor request code of the failed request.
• data — never used? 🤔 that's genuinely what the manpage says. it just says "Never used?" with a question mark and everything. the uncertainty is real, bestie. not me side-eyeing a struct field.

---

🦋 DESCRIPTION 🦋

error events get sent to clients to alert them about non-fatal errors encountered while processing requests. so like — it's not the end of the world, it's not a crash, it's just the server being like "hey, that request? didn't work. just so you know. 💌"

non-fatal. breathe. you're fine. the vibe check failed but the program lives.

---

🌈 SEE ALSO 🌈

go read these too, they're all part of the family:

• AuAnyEvent
• AuElementNotifyEvent
• AuGrabNotifyEvent
• AuMonitorNotifyEvent

and also:

• audiolib — Network Audio System C Language Interface

---

fr fr if you're handling errors in your audio client, this is the struct you're gonna be staring at. get comfy with her.

---

okay that's the whole page!! 🫶 this was audiolib - events, version 1.9.5, from the AuErrorEvent(3) manual page. ty for reading bestie, go write some slay code ✨💜