socket_bind6(3)

💖 socket_bind6 — bestie's guide to claiming your socket's home address 💖

okay so real quick, this is a page from the Library Functions Manual (the socket_bind6(3) one, yes the 3 means it's a library function, iykyk) 🎀

✨ NAME ✨

socket_bind6 — set the local IP address and port of a socket

like... you're giving your socket an address. a little home. a vibe. 🏠✨

🌸 SYNTAX 🌸

#include <libowfat/socket.h>

int socket_bind6(int s, char ip[16], uint16 port,
                 uint32 scope_id);

🦋 DESCRIPTION 🦋

So socket_bind6 sets the local IP address and TCP/UDP port of a TCP/UDP socket s to ip and port respectively. It's giving "this is where I live now" energy 💅

• If the IP address is ::, the operating system chooses a local IP address. Let the OS cook. 👑
• If port is 0, the operating system chooses a port. Also letting the OS cook. 🍓

Normally socket_bind6 returns 0. It's chill like that. 😌 But if anything goes wrong, it returns -1 and sets errno appropriately — so go check errno, bestie, don't just sit there wondering. 😭

The scope_id should normally be zero, but for link-local addresses it specifies the interface number on which to bind. Basically: which network interface you're binding to. 🌈 And you can find the interface number for a given network interface name with socket_getifidx. bestie helping bestie fr fr 🫶

⭐ EXAMPLE ⭐

#include <libowfat/socket.h>

int s;
char ip[16];
uint16 p;
uint32 scope_id;

s = socket_tcp6();
socket_bind6(s,ip,p,scope_id);
socket_connect6(s,ip,p);

look at that. bind then connect. main character socket behavior. 🔥

👑 SEE ALSO 👑

• socket_bind4(3)
• socket_getifidx(3)

and that's the whole thing!! this page is literally socket_bind6(3) and it's been iconic from top to bottom, no cap 💖💜✨