dns_ip4(3)

💖 dns_ip4 — look up IPv4 addresses 💖

okay bestie, welcome to dns_ip4(3) from the Library Functions Manual, this is the one that gets you those sweet sweet 4-byte IP addresses 🦋

✨ NAME ✨

dns_ip4 — look up IPv4 addresses. that's it. that's the vibe. 👑

🌸 SYNTAX 🌸

#include <libowfat/dns.h>

int dns_ip4(stralloc* out,stralloc* fqdn);

two stralloc*s, one int, no drama. 💅

🎀 DESCRIPTION 🎀

so like. dns_ip4 looks up the 4-byte IP addresses for the fully-qualified domain name sitting in fqdn. it takes the concatenation of those IP addresses, drops them into out, and returns 0. iconic behavior, no notes. ✨

and if the domain doesn't exist in DNS, or it exists but has no IP addresses? then out will be empty. like, ghosted. 💀

now for the part where it gets real. if dns_ip4 has trouble with the DNS lookup, or if it runs out of memory, it returns -1 and sets errno appropriately. also — heads up — it may or may not change out. so don't go trusting out after a -1, bestie, that's not a safe place to be. 🙈

but wait, here's the fun shortcut 🍓: if fqdn is already a dotted-decimal IP address, dns_ip4 just puts that IP address into out without checking DNS. why ask the internet when you already know the answer, right?

and more generally — yes, it gets more general, she contains multitudes — if fqdn is a dot-separated sequence of dotted-decimal IP addresses, dns_ip4 puts those IP addresses into out without checking DNS too. multi-IP slay. 💅

also, brackets may appear inside the dotted-decimal IP addresses, and they are ignored. they're just there for decoration i guess, we don't question them. 🎀

ngl, the "may or may not change out" thing is the one to remember. that's the lore. 🫶

🌈 SEE ALSO 🌈

• dns_ip4_packet(3)
• dns_ip6(3)
• dns_name4(3)

and that's the whole page, bestie 💖 this was dns_ip4(3), living in the Library Functions Manual, and yes she's still called dns_ip4(3) on the way out too — she said her name twice because she's that girl. 🌟 periodt. 🎀🦋✨