pbs_iff(8B)

💖 NAME 💖

okay so bestie, meet pbs_iff(8B) — the little tool that tests authentication with the server. That’s the whole vibe check: it checks auth with the server. ✨

🌸 SYNOPSIS 🌸

pbs_iff [-t] <server host> <server port>

pbs_iff --version

🦋 DESCRIPTION 🦋

So here’s the tea: pbs_iff is called from the pbs_connect() IFL API to authenticate a connection with the PBS server. It’s designed to be called internally by PBS commands and components, and it’s used by our IFL layer to talk to the server. no cap. 💅

If pbs_iff cannot authenticate, it returns an error message. periodt.

Required Privilege: can be run by any user. literally anyone. 🫶

It’s a setuid root binary, so it runs as the user who requests a connection to a server, but it becomes root so that it can grab a privileged port. iconic behavior, honestly. 👑

✨ OPTIONS TO pbs_iff ✨

• -t — test mode; means test whether pbs_iff can authenticate with the server. 🧚
• --version — reports version and exits; can only be used alone. no extra friends allowed, bestie. 💀

🎀 ARGUMENTS TO pbs_iff 🎀

• daemon host — host where the server is running. 📍
• daemon port — port on which the server is listening; default is 15001. 🍓

🔥 EXIT STATUS 🔥

• Zero — if pbs_iff is able to contact the server at the specified port. slay. ✅
• Non-zero — if pbs_iff is unable to contact the server at the specified port. 😭

💖 that’s the tea from Local, dated 18 October 2017 — pbs_iff(8B) out! 💖