socket_info(3)

📦 version 31, in alpine 3.24

✨ NAME ✨

okay so socket_info(3) — from the Library Functions Manual, bestie — is literally the page for retrieving IP connection information for an existing socket. It's giving "tell me about this socket's IP situation" energy 💅✨

🎀 SYNTAX 🎀

       #include "socket_if.h"

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

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

No cap, those are the exact signatures. Slay. 💖

🦋 DESCRIPTION 🦋

  • socket_local — returns the local IPv6 or IPv4-mapped IPv6 address as ip, the port as port, and perhaps the scope_id as scope_id for the UDP or TCP socket. It's the "where am I?" of socket lore 😭🌐
  • socket_remote — returns the remote IPv6 or IPv4-mapped IPv6 address as ip, the port as port, and perhaps the scope_id as scope_id for the UDP or TCP socket. That's the "who's on the other end?" vibe fr fr 🫶

💀 RETURN CODES 💀

If something goes wrong, socket_local and socket_remote return -1, setting errno appropriately. So if you see -1, bestie, that's the plot twist — and errno is the tea 😭💀

🍓 EXAMPLE 🍓

       #include <socket_if.h>
         int s;
         char ip[16];
         uint16 port;

         if (socket_remote(s,ip,&port,0) == -1)
           err_tmp("",111,"unable to get remote address: ");

Literally the whole example, no edits, periodt 💅

👑 SEE ALSO 👑

bye bestie! 💖 signing off from the Library Functions Manual with socket_info(3) as the footer's source/version — and since no date is printed there, we're not inventing one, periodt 🎀✨

📦 where this page comes from