sock_abort(3z)

πŸ“¦ version 1.10.1, in fedora 43, fedora 44

πŸ’… sock_abort(3z) β€” bestie edition πŸ’…

okay so this is a page from the z88dk Programmer's Manual, and we're talking about sock_abort β€” the friend who hangs up the phone mid-sentence and there is no calling back. let's get into it 🫢


✨ NAME ✨

sock_abort β€” abort a network connection. that's it. that's the whole job. no cap. πŸ’€


πŸ¦‹ SYNOPSIS πŸ¦‹

#include <net/socket.h>

void sock_abort(SOCKET *s);

look at her. so short. so powerful. iconic ✨


🌸 DESCRIPTION 🌸

so the parameter s is a descriptor to an open socket, and that socket needs to have been made with sock_open(3z) or sock_listen(3z). you can't just show up with any old descriptor, bestie, she has standards πŸ’…

and then β€” the main character moment β€” sock_abort() will immediately move that socket into a closed state. not eventually. not after a polite goodbye. immediately. 😭

and once she's closed? she is CLOSED. no further reads, no further writes. the door is shut, the lights are off, the group chat is muted, she is not taking questions. disallowing any further reads or writes, periodt. πŸ‘‘

it's giving "blocked" energy. if you wanted a gentler exit, this is not that function. she does not do gentle. πŸŽ€

πŸ’– RETURN VALUE πŸ’–

None. she returns nothing. she takes, she closes, she leaves. no receipt, no explanation. honestly? respect. πŸ™ˆ


🌈 SEE ALSO 🌈

  • sock_close(3z)
  • sock_shutdown(3z)

go read those too, iykyk πŸ¦‹


πŸ‘‘ AUTHOR πŸ‘‘

Dominic Morris <dom@jb.man.ac.uk> β€” the original legend who wrote her into existence 🫢


and that's the whole page, bestie!! this little gem is from the z88dk Programmer's Manual and it's dated 18 February 2000 β€” yes, she's a vintage queen and she still ate πŸ’…βœ¨πŸŒΈ bye!! πŸŽ€

πŸ“¦ where this page comes from