SCTP_PEELOFF(2)

💖 SCTP_PEELOFF(2) 💖

okay so bestie, welcome to the System Calls Manual — this one lives in section 2, so it's a real-deal syscall, not some lil shell command. it's literally called sctp_peeloff and i'm obsessed 🦋

✨ NAME ✨

sctp_peeloff — detach an association from a one-to-many socket so it gets its own fd 💅

📚 LIBRARY 📚

Standard C Library (libc, -lc)

like yes, it's just chillin' in libc, nothing extra to link, you're welcome 🫶

🌸 SYNOPSIS 🌸

#include <sys/types.h>
#include <sys/socket.h>
#include <netinet/sctp.h>

int
sctp_peeloff(int s, sctp_assoc_t id);

👑 DESCRIPTION 👑

okay so here's the tea ☕ — the sctp_peeloff() system call attempts to detach the association specified by id into its own separate socket. that's it, that's the whole vibe. one-to-many socket in, independent socket out, main character energy for everybody 🌈

🎀 RETURN VALUES 🎀

• failure → the call returns -1 😭
• success → it returns the new socket descriptor ✨

periodt. no in-between.

💀 ERRORS 💀

the sctp_peeloff() system call can return the following errors, and ngl some of these are giving "check ur args bestie":

• [ENOTCONN] — the id you handed to the call does not map to a valid association 🙈
• [E2BIG] — the size of the address list exceeds the amount of data provided 💀
• [EBADF] — the argument s is not a valid descriptor 🚫
• [ENOTSOCK] — the argument s is not a socket 😭 like bestie that's just not a socket

🦋 SEE ALSO 🦋

• sctp(4)

and that's the whole page, mwah 💋 this little gem comes to you from Debian, dated October 30, 2007 — yeah she's an elder but she still slays, okurrr 👑✨🎀