wrapsrv(1)

✨ wrapsrv — the manual, but make it cute ✨

okay bestie, listen up 💖 this is wrapsrv, section 1 of the manual, and she is literally the friend who translates between two people who refuse to talk to each other. the DNS world and your mid command. let's get into it 🎀

🌸 NAME 🌸

wrapsrv — DNS SRV record command line wrapper

like. that's the whole vibe. she wraps your service, she wraps your command. iykyk 💅

🦋 SYNOPSIS 🦋

wrapsrv [SRVNAME] [COMMAND] [OPTION]...

so it's wrapsrv, then optionally the SRVNAME, then your COMMAND, then whatever OPTION... your command wants. slay. no cap ✨

💜 DESCRIPTION 💜

okay so here's the tea, and it's actually iconic 🫶

wrapsrv adds support for connecting to a network service based on DNS SRV record lookups — to commands that do not support the DNS SRV record. yes, she's the bridge. she's the group chat translator. she's giving main character energy for your crusty old binary that has never heard of SRV records and never will 🙈

and not only does she do that, she implements the weighted priority client connection algorithm in RFC 2782. fr fr. the actual spec. she read it. she understood it. she did the homework 📚✨

the specified command line will be invoked one or more times with %h and %p sequences in the command line substituted for the hostname and port elements of the selected SRV record. so you write your command with %h and %p placeholders and she swaps them in like a little outfit change 💅🦋

now here's the important part, so pay attention bestie:

the command line invoked must exit and return 0 after a successful connection, or exit and return non-zero if the connection fails. that's the contract. that's the deal. she's trusting you and you cannot fumble this one 😭

wrapsrv will itself exit with the return code of the last command line invocation. so whatever your last attempt said, she says too. and she may also exit with a non-zero return code if the DNS SRV record lookup fails for any reason. which. yeah. sometimes DNS just does that to us 💀

and that's the whole page, bestie!! she's short but she's powerful, a real "small but mighty" situation 👑

this little icon came from the wrapsrv(1) manual, dated 13 December 2013. that's the source and the version and the date all in one, and honestly, vintage. timeless. periodt 🌈💖✨