socket_send4(3)

💌 socket_send4 — bestie's guide to yeeting a UDP datagram

okay so this is a page from the Library Functions Manual (yes that's the whole manual name, we're being fancy today), and it's all about socket_send4(3). let's get into it 💖

---

✨ NAME ✨

socket_send4 — send a UDP datagram

like. that's it. that's the whole job. one datagram, out the door, no strings attached. 💅

---

🦋 SYNTAX 🦋

#include <libowfat/socket.h>

ssize_t socket_send4(int s, const char* buf, size_t len,
                     const char ip[4],uint16 port);

look at her. five little args and she's ready to go. 🌸

---

👑 DESCRIPTION 👑

so socket_send4 sends len bytes, starting at buf, inside a UDP datagram. where's it going? over the socket s, to UDP port port, on IP address ip. that's the whole vibe check. 📬

and here's the part that's genuinely so considerate of her: you can call socket_send4 without calling socket_bind4 first. it does not care. the effect is the same as if you had called socket_bind4 first with IP address 0.0.0.0 and port 0. so like, she binds for you. main character energy fr fr. 🫶

---

🌈 RETURN VALUE 🌈

• 0 — the datagram was sent successfully. slay. we ate. 🎀
• -1 — nope, it didn't work, and errno gets set appropriately so you can go find out why. 😭

---

🍓 EXAMPLE 🍓

#include <libowfat/socket.h>

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

s = socket_tcp4();
socket_bind4(s,ip,p);
socket_send4(s,"hello, world",12,ip,p);

literally sending "hello, world" into the void. iconic. ✨

ngl bestie, this is the example exactly as she wrote it — socket_tcp4(), the socket_bind4(s,ip,p) line, all of it. don't come for me, i don't make the rules. 🙈

---

💜 SEE ALSO 💜

• socket_send6(3) — her IPv6 sister. same energy, longer addresses. 🌟

---

and that's the page!! written by the libowfat girlies, straight out of the Library Functions Manual — socket_send4(3), mwah. go send a datagram, you've got this. 💖✨🎀