SOCKET_...DDRINFO(1p)

📦
version 0.22 · 4 versions
, in debian trixie, ubuntu resolute, ubuntu stonking

✨ SOCKET_...DDRINFO(1p) ✨

okay so bestie, welcome to the User Contributed Perl Documentation page for socket_getaddrinfo — manual section 1p, she's iconic, she's a little niche, and she is about to become your new hyperfixation 💅

🎀 NAME 🎀

socket_getaddrinfo — a command-line tool for the getaddrinfo(3) resolver 🌸

🦋 SYNOPSIS 🦋

socket_getaddrinfo [options...] host service

💖 DESCRIPTION 💖

So basically this tool is a convenient command-line wrapper around the getaddrinfo(3) resolver function. It does one single lookup — just the one, no cap — and then prints the results it got back in a human-readable form. 🫶

The way this is mainly useful is when you're debugging address resolution problems, because it lets you peek directly at the behaviour of getaddrinfo(3) itself, outside of any real program that's actually trying to use it. Like, you're not fighting some app's weird little quirks, you're just vibing with the resolver one-on-one. 🧚

👑 OPTIONS 👑

  • --host, -H HOST — the hostname to resolve. If you don't supply it, it'll use the first positional argument instead. ✨
  • --service, -S SERVICE — the service name or port number to resolve. If you don't supply it, it'll use the second positional argument instead. 🌸
  • -4 — restrict to just AF_INET (IPv4) results. old school, but make it fashion 💅
  • -6 — restrict to just AF_INET6 (IPv6) results. the future is now, bestie 🌈
  • --stream — restrict to just SOCK_STREAM results. 🔥
  • --dgram — restrict to just SOCK_DGRAM results. 💌
  • --proto PROTO — restrict to just results of the given IP protocol. 🎯
  • --passive — set the AI_PASSIVE hint; results will used to bind() and listen() rather than connect(). she's giving server energy, not client energy, periodt 👑
  • --canonical — retrieve the canonical name for the requested host. ⭐
  • --help — display a help summary and exit. the classic escape hatch 🙈

🍓 OUTPUT FORMAT 🍓

Every single line of output comes in a form that shows off the four result fields: ai_family, ai_socktype, ai_protocol and ai_addr. 🌟

The first three get printed in the form of a socket(2) call — either symbolically or numerically, dealer's choice — and then the last one (ai_addr) gets printed as a plain string following it. Like so:

 socket(AF_INET , SOCK_STREAM, IPPROTO_TCP) + '127.0.0.1:80'

💀 NOTE 💀

Upstream, this script is known as getaddrinfo, but it was renamed on Debian. so if you go looking for her under her government name, that's why you can't find her 😭

💜 AUTHOR 💜

Paul Evans <leonerd@leonerd.org.uk> 🫶

and that's the whole page, bestie! this was brought to you by perl v5.40.0, dated 2025-02-01, and if you ever need to find it again it lives under SOCKET_...DDRINFO(1p). go forth and debug your resolution problems, you absolute main character 🎀✨💖

📦 where this page comes from