RULI(1)

📦 version 0.36, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 RULI — bestie edition 💖

okay so this is the manual page for RULI(1), from the General Commands Manual section of your local man setup, and it's literally all about the sample programs that ship with the RULI library 💅 we're doing RFC 2782 SRV lookups and we're doing them cute.

✨ NAME ✨

srvsearch, sync_srvsearch, smtpsearch, sync_smtpsearch, httpsearch, sync_httpsearch, ruli-getaddrinfo, getaddrinfo — these are the sample programs for the RULI Library, and yes they do RFC 2782 things 🦋

🌸 SYNOPSIS 🌸

like, just pipe an SRV-ish name into them and go:

echo _service._protocol.nongnu.org | getaddrinfo
echo _service._protocol.nongnu.org | ruli-getaddrinfo [ options ]
echo _service._protocol.nongnu.org | srvsearch [ options ]
echo _service._protocol.nongnu.org | sync_srvsearch [ options ]
echo nongnu.org | smtpsearch [ options ]
echo nongnu.org | sync_smtpsearch [ options ]
echo nongnu.org | httpsearch [ options ]
echo nongnu.org | sync_httpsearch [ options ]

see how the smtp/http ones only want the bare domain? yeah. different vibe, different input 👑

💜 DESCRIPTION 💜

This manual page documents, briefly, the sample programs for the ruli(3) library. Short and sweet, we love that for us.

ruli is a library aimed at querying DNS SRV resource records — that's the whole point of it, no cap.

🎀 OPTIONS 🎀

For http searches, one can force the port number by specifying it as the first option. (yes, first. position matters, bestie, it's giving picky but okay.)

  • search — use the resolver search list defined in /etc/resolv.conf 🔍
  • need_ra — require the RA (Recursion Available) bit in the name server answer. no RA, no vibes.
  • noinet — don't fetch IPv4 addresses 🙈
  • noinet6 — don't fetch IPv6 addresses 🫶
  • uri_port — assume the specified default port was forced by the user-supplied URI
  • nowalk — don't search addresses that are missing from the name server answer
  • nofall — don't launch fallback queries for addresses, if the SRV query fails 💀
  • nosort6 — don't sort the address list to give preference to IPv6 addresses
  • rfc3484 — enable RFC3484 destination address selection rules ⭐
  • cname — allow CNAME in SRV targets 👑

🌈 EXAMPLES 🌈

copy-paste these, they ate:

echo _sip._udp.nongnu.org | getaddrinfo
echo _telnet._tcp.nongnu.org | ruli-getaddrinfo rfc3484
echo _smtp._tcp.nongnu.org | srvsearch search
echo _smtp._tcp.nongnu.org | sync_srvsearch search noinet6
echo nongnu.org | smtpsearch noinet
echo nongnu.org | sync_smtpsearch nowalk nofall
echo nongnu.org | httpsearch noinet6
echo nongnu.org | sync_httpsearch 80

note that last one? 80 sitting right there in first-option position like the OPTIONS section promised 😌 consistency is the moment.

🦋 SEE ALSO 🦋

👑 AUTHOR 👑

This manual page was written by Everton da Silva Marques <evertonsm@yahoo.com.br> — thank you for your service, legend 🫶

and that's the whole page, bestie!! this version of RULI(1) is dated September 1, 2005, living in the General Commands Manual section forever and ever, and honestly? iconic. periodt. 💅✨

📦 where this page comes from