reverse_addr(3z)

💖 NAME 💖

okay so bestie, this is reverse_addr(3z) from the z88dk Programmer's Manual — and the actual function name is reverse_addr_lookup. The NAME line is literally reverse_addr_lookup - convert IP address to hstname (yes, hstname, we are not fixing it, we are keeping it exactly). It converts an IP address to a hostname. That's the whole vibe. ✨

🦋 SYNOPSIS 🦋

#include <net/resolv.h>

bool_t reverse_addr_lookup(ipaddr_t ipaddr, char *name);

🌸 DESCRIPTION 🌸

The reverse_addr_lookup() function queries any configured nameservers for the name of the host with IP address ipaddr. Like, it's asking around: "hey, who is this IP?" 💅

If ipaddr is not known to the queried nameservers then the ipaddr is converted to the form a.b.c.d and returned. So if nobody knows them, they get their own numeric little name back. periodt.

🫶 RETURN VALUE 🫶

reverse_addr_lookup() places the hostname in the buffer specified by name, no checks are made that this buffer is large enough to hold the full hostname. 👀

bestie, fr fr, no checks. That's exactly what the page says.

The function returns TRUE or FALSE depending on whether the queried nameservers knew ipaddr. So TRUE = they knew the IP, FALSE = they didn't.

reverse_addr_lookup() may also be called by the macro gethostbyaddr. iykyk.

💀 BUGS 💀

If you use the macro gethostbyaddr then beware that the ZSock implementation is not at all standard. Not me being dramatic, that's literally the note. 🚩

👑 AUTHOR 👑

Dominic Morris <dom@jb.man.ac.uk> — iconic. 💜

okay that's the whole reverse_addr(3z) page, from the z88dk Programmer's Manual, dated 18 February 2000. slay. 💖