xpaopen(3)

💖 xpaopen(3) — the SAORD Documentation girlies know 💖

okay so bestie, welcome to the xpaopen(3) page — she's short, she's sweet, she's the one you call when you're tired of reconnecting to servers over and over like it's a situationship. let's get into it 🦋

---

✨ NAME ✨

XPAOpen — allocate a persistent client handle 💅

---

🌸 SYNOPSIS 🌸

#include <xpa.h>

XPA XPAOpen(char *mode);

---

🎀 DESCRIPTION 🎀

okay so XPAOpen() allocates a persistent XPA struct, and that struct is the bestie you bring along to calls of XPAGet(), XPASet(), XPAInfo(), XPAGetFd(), and XPASetFd(). 🫶

and what does persistent even mean here? it means the connection to an XPA server does not get closed when one of those calls finishes — she stays up and gets re-used on successive calls. the way that saves you the time it takes to connect to a server 😭 like, this genuinely matters when connections are slow, or when you're gonna have a large number of exchanges with a given access point. iconic behavior tbh.

the mode argument? currently it's just ignored — "reserved for future use". so don't stress about it, girl, it's giving placeholder energy.

if XPAOpen() worked, you get an XPA struct back. if not? NULL. periodt. 💀

that returned struct can be passed as the first argument to XPAGet(), etc. those calls will update the list of active XPA connections:

• servers that are already connected (from a previous call) — stay connected, no drama 💜
• new servers — also get connected ✨
• old servers (from a previous call) that are no longer needed — get disconnected 🚪

and the connected servers remain connected when the next call to XPAGet() is made, at which point the connections get updated once again. it's a whole cycle, and she's thriving. 🌈

🧚 Example 🧚

#include <xpa.h>

XPA xpa;
xpa = XPAOpen(NULL);

---

👑 SEE ALSO 👑

See xpa(n) for a list of XPA help pages 📚

---

okay bestie that's the whole page, we ate and left no crumbs 🍓 this was version 2.1.15, dated July 23, 2013 — mwah, go forth and keep those connections persistent 💖✨🎀