SCTP_BINDX(3)

💖 SCTP_BINDX(3) 💖

okay bestie, welcome to the sctp_bindx page — it's from the Linux Programmer's Manual and it's literally all about adding and removing bind addresses on a socket. let's get into it 🦋

✨ NAME ✨

sctp_bindx — Add or remove bind addresses on a socket.

🌸 SYNOPSIS 🌸

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

int sctp_bindx(int sd, struct sockaddr * addrs, int addrcnt,
               int flags);

💅 DESCRIPTION 💅

so here's the tea ☕ — sctp_bindx adds or removes a whole set of bind addresses. the addresses come in as an array called addrs, and they get added to (or removed from) the socket sd. the addrcnt param is how many addresses are chillin' in that array, and the flags param is the vibe check that says whether we're adding or removing. no cap.

now, family matters (literally) 💀 — if sd is an IPv4 socket, the addresses you pass must be IPv4 addresses. if sd is an IPv6 socket, then the addresses you pass can be either IPv4 or IPv6. slay, flexible queen.

addrs is a pointer to an array of one or more socket addresses. each address lives inside its own appropriate structure, i.e. struct sockaddr_in or struct sockaddr_in6. the family of the address type is what you use to figure out the address length — that's the key, iykyk. and the caller is the one who tells us how many addresses are in the array, via addrcnt.

the flags parameter can be either SCTP_BINDX_ADD_ADDR or SCTP_BINDX_REM_ADDR:

• SCTP_BINDX_ADD_ADDR — an app can use this to associate additional addresses with an endpoint after calling bind(2). main character energy fr fr.
• SCTP_BINDX_REM_ADDR — this directs SCTP to remove the given addresses from the association.

⚠️ okay important bestie: a caller may not remove all addresses from an association. it will fail with EINVAL. periodt. 💀

🫶 RETURN VALUE 🫶

• On success, 0 is returned. ✨
• On failure, -1 is returned, and errno is set appropriately.

😭 ERRORS 😭

• EBADF — sd is not a valid descriptor. not it. 🙈
• ENOTSOCK — sd is a descriptor for a file, not a socket. girl, that's a file. 💀
• EFAULT — Error while copying in or out from the user address space.
• EINVAL — Invalid port or address, or trying to remove all addresses from an association.
• EACCES — The address is protected, and the user is not the super-user. no root, no entry 🎀

🌈 SEE ALSO 🌈

sctp(7) sctp_sendmsg(3), sctp_sendv(3), sctp_send(3), sctp_recvmsg(3), sctp_recvv(3), sctp_peeloff(3), sctp_getpaddrs(3), sctp_getladdrs(3), sctp_opt_info(3), sctp_connectx(3)

and that's the whole page, bestie 💖 this one's from Linux 2.6, dated 2005-10-25, and it's filed under SCTP_BINDX(3). go forth and bind responsibly, queen 👑✨