AuKillClient(3)

💅 AuKillClient — it's giving bye bestie 💀

ok so this is a page from the Library Functions Manual (section 3, the library-functions girlies ✨) — the function is literally called AuKillClient and yes the name is dramatic but it's doing exactly what it says on the tin, no cap.

---

✨ NAME ✨

AuKillClient — destroy a client or its remaining resources 🪦

like… it's the close the tab, clear the cache, log all the way out function. very main character, very final.

---

🌸 SYNOPSIS 🌸

#include <audio/audiolib.h>

void AuKillClient(server, resource, status)
    AuServer *server;
    AuID resource;
    AuStatus *status; /* RETURN */

she returns void, meaning she gives you nothing back except the sweet release of destruction. queen behaviour honestly 👑

---

🎀 ARGUMENTS 🎀

• server — the connection to the audio server. your lil hotline to the server bestie ☎️
• resource — the resource that's associated with the client you wanna destroy… or the constant AuCloseDownDestroy. pick your fighter 💅
• status — if this is non-NULL, it flushes the output buffer and returns the status from the server. so if you actually want to know how it went, hand her a pointer, bestie. it's a RETURN value (the source literally comments /* RETURN */, iykyk).

---

🦋 DESCRIPTION 🦋

ok so here's the tea, fr fr:

AuKillClient forces a close-down of the client that created resource. like, not a polite "hey are you done", an actual forced shutdown. periodt.

and then — the way that it works is:

• if that client has already terminated in either AuCloseDownRetainPermanent or AuCloseDownRetainTemporary mode, then all of the client's resources are destroyed. every last one. gone. 🫶
• if resource is AuCloseDownDestroy, then the resources of all clients that have terminated in AuCloseDownRetainTemporary are destroyed. not one client — all of them. it's giving spring cleaning, it's giving closing time at the function 🌈

so yeah. she does not do half measures. she does not leave crumbs. she's the friend who actually deletes the ex's number 💀

---

💀 ERRORS 💀

• AuBadValue.

that's it. that's the whole list. one (1) error and it's AuBadValue. not me getting off easy 😭

---

👑 SEE ALSO 👑

• AuSetCloseDownMode — the one that sets the mode, so go read her if you're confused about where AuCloseDownRetainPermanent and AuCloseDownRetainTemporary come from, bestie 🧚
• audiolib — Network Audio System C Language Interface. the whole vibe, the mothership, the blueprint ⭐

---

and that's the page!! this one shipped as part of audiolib — client connections, version 1.9.5 💖 so if you ever need to force a client's whole existence out of the room, you know who to call. mwah, take care of urself, hydrate, and don't AuKillClient anyone you wouldn't AuKillClient at least twice 🎀✨