ROAR_SOCKET_NONBLOCK(3)

📦 version 1.0~beta12, in ubuntu jammy

💖 roar_socket_nonblock — it's in section 3 of the System Manager's Manual, bestie, and it's giving RoarAudio 💖

okay so picture this: you've got a socket, right? and it's just sitting there being all blocking and dramatic, and you're like "girl, I do not have time to wait for you." That's literally this function. roar_socket_nonblock flips the blocking state of a socket and it's so simple it's honestly iconic. ✨

🌸 SYNOPSIS 🌸

#include <roaraudio.h>

int roar_socket_nonblock(int fh, int state);

two args, one int back, no drama. we love a low-maintenance queen. 💅

🦋 DESCRIPTION 🦋

So what does it actually do? It sets the blocking mode of a given filehandle. That's it, that's the whole vibe. 🫶

If you're sitting there like "bestie what even IS nonblocking IO," no worries, the original author said it best: go read open(2) and look for O_NONBLOCK. That's the lore. 📖✨

🎀 PARAMETERS 🎀

  • fh — the filehandle you're setting the new state on. hand it over, she's getting a glow-up. 💖
  • state — the new state you want, and you've got exactly two moods to pick from:
    • ROAR_SOCKET_BLOCK — sets blocking mode. back to the old ways, she waits. 😴
    • ROAR_SOCKET_NONBLOCK — sets nonblocking mode. main character energy, no waiting around. 🔥
    • and just so we're clear, ROAR_SOCKET_NONBLOCK is the same as setting O_NONBLOCK within open(2). same energy, different spelling. iykyk. 💜

👑 RETURN VALUE 👑

  • on success — these calls return 0. slay. ✨
  • on error — -1 is returned. not slay. 😭
fr fr, always check that return value. -1 is the group chat notification you do NOT want to ignore. 💀

🌈 EXAMPLES 🌈

FIXME

yeah bestie the examples section literally just says FIXME 😭 the maintainers left us on read. not me being obsessed with a TODO though. 🙈

🍓 SEE ALSO 🍓

go read these, they're the supporting cast and they ate. 💅🌸

RoarAudio ✨ May 2011 — that's the source, the version, and the date, and yes we're closing this out like a signature on a love letter. mwah. 💖🎀🦋🧚⭐

📦 where this page comes from