socket_bind6_reuse(3)

💖 socket_bind6_reuse — bestie's guide to claiming your IPv6 throne 💖

okay so this one lives in section 3 of the Library Functions Manual, aka the part of the manual where we keep all the library function girlies. sit down, grab a strawberry 🍓, and let's get into it.

---

✨ NAME ✨

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

no cap, that's the whole vibe: you're telling a socket where it lives on the local machine.

---

🌸 SYNTAX 🌸

#include <libowfat/socket.h>

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

that's the whole signature, copy it exactly bestie, don't get cute with it 🎀

---

💅 DESCRIPTION 💅

so socket_bind6_reuse sets the local IP address and TCP/UDP port of a TCP/UDP socket s to ip and port respectively. literally just: you give it the socket, it gives the socket an address. iconic.

if the IP address is ::, the operating system chooses a local IP address. if port is 0, the operating system chooses a port. so if you're feeling indecisive, the OS is your main character and will pick for you ✨

normally socket_bind6_reuse returns 0. if anything goes wrong, socket_bind6_reuse returns -1, setting errno appropriately. so like, check your return values, i'm begging 😭

the scope_id should normally be zero, but for link-local addresses it specifies the interface number on which to bind. the interface number for a given network interface name can be found with socket_getifidx. so if you're doing link-local stuff, that's your girl 💜

unlike socket_bind6 this function will also tell the operating system that the address is to be reused soon, which turns off the normal pause before this IP and port can be bound again. that's the whole point of the _reuse in the name — it skips the little cooldown period. no waiting around, we hate waiting 💀

heads up bestie: "reuse soon" means you're telling the kernel the address is coming back fast. that's the feature, that's why you'd pick this over socket_bind6. don't be surprised when the normal pause just… isn't there.

---

🌈 EXAMPLE 🌈

#include <libowfat/socket.h>

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

s = socket_tcp4();
socket_bind6_reuse(s,ip,p);
socket_connect4(s,ip,p);

look at her go. make a socket, bind it with the reuse energy, then connect. simple, clean, slay 👑

---

🦋 SEE ALSO 🦋

• socket_bind6(3)

---

and that's the whole page fr fr. this one comes to you courtesy of the Library Functions Manual, section 3 — the socket_bind6_reuse(3) energy, immortalized forever. go bind something responsibly, bestie 💖✨🎀🫶