sock_closed(3z)

📦 version 1.10.1, in fedora 43, fedora 44

✨ sock_closed ✨

okay so bestie, real talk — this is the z88dk Programmer's Manual and we're talking about sock_closed(3z), which is literally just the "is this socket ghosting me?" detector 💅

🌸 NAME 🌸

sock_closed — test whether a network connection is closed

🦋 SYNOPSIS 🦋

#include <net/socket.h>

bool_t sock_closed(SOCKET *s);

💖 DESCRIPTION 💖

So. The parameter s? That's a descriptor to a socket. And not just any socket — one you made with sock_open(3z) or sock_listen(3z). Those are the only ones invited to this party, no random sockets showing up unannounced 💀

What sock_closed() does is test whether a socket is closed — and yes, "closed" here means exactly what you think. Either the connection to a remote host was never established in the first place, or it already got closed by the kernel. Either way, it's giving "this link is not it" 😭

Heads up though: a socket of prot_UDP is never closed. Like, never ever. UDP said "I'm not leaving" and honestly? Respect. 🫶

🎀 RETURN VALUE 🎀

sock_closed() returns TRUE or FALSE. That's it. That's the whole vibe check. ⭐

🌈 SEE ALSO 🌈

  • sock_opened(3z) — the other half of the duo, iykyk

👑 AUTHOR 👑

Dominic Morris <dom@jb.man.ac.uk> — the icon who wrote this, we stan 🫶

and that's the whole page, bestie!! this one came from the z88dk Programmer's Manual, dated 18 February 2000 — yes she's vintage, yes she still slays, periodt 💜✨

📦 where this page comes from