AuCloseServer(3)

💅 AuCloseServer — bestie's guide to saying bye to the audio server

ok so real talk, this one's from audiolib, the Network Audio System C Language Interface — a whole library of functions for talking to an audio server, and this specific page lives in the Library Functions Manual. It's giving housekeeping energy, it's giving "time to log off," and honestly? iconic. 🎀

✨ NAME ✨

AuCloseServer — disconnect from the audio server

like, that's it. that's the whole vibe. you're hanging up the phone on the server. 📞💖

🌸 SYNOPSIS 🌸

#include <audio/audiolib.h>

void AuCloseServer(server)
    AuServer *server;

so you pull in the header, and then boom — void, meaning it hands nothing back to you. no return value, no receipt, no "thanks for calling." just vibes and closure. 🦋

🫶 ARGUMENTS 🫶

• server — Specifies the connection to the audio server.

that's the one and only thing you gotta hand over: the connection to the audio server. the little thread tying you to it. give it here bestie, we're cutting it. ✂️

👑 DESCRIPTION 👑

AuCloseServer closes the connection to the audio server. periodt, that's the main event. 💅

but here's the tea, and it's lowkey important — what happens to your stuff after you dip depends entirely on the client's close-down-mode:

• If the client's close-down-mode is AuCloseDownDestroy, all resources associated with the client will be released. 🔥 everything goes. full clean slate, no crumbs left behind, the resources get absolutely ate.
• If the client's close-down-mode is AuCloseDownRetainTemporary or AuCloseDownRetainPermanent, the resources associated with the client are retained until the server is reset or AuKillClient is called. 😭 so like… your stuff is still sitting there. haunting the server. waiting. it does not get released when you close the connection — it hangs around until either the server gets reset, or somebody comes through and calls AuKillClient.

bestie be aware: if you're on AuCloseDownRetainTemporary or AuCloseDownRetainPermanent, closing the connection is not the same as cleaning up. your resources are still out here, retained, and they stay that way until a server reset or an AuKillClient. no cap. 🫶

🌈 SEE ALSO 🌈

• AuOpenServer — the one that gets you into the server in the first place, iykyk
• AuFlush — for flushing, obviously
• AuGetCloseDownMode — go check what your close-down-mode actually is before you assume anything 👀

and also, the whole family: audiolib — Network Audio System C Language Interface 💜

🧚 cute little sign-off 🧚

this page comes to you from audiolib - housekeeping, version 1.9.4, and it's filed under AuCloseServer(3) in the Library Functions Manual. go forth, close that connection, and know your resources' fate before you do. slay. ✨🎀💖