xpaserver(3)

✨ NAME ✨

XPAServer — the XPA server-side programming interface, bestie 💖 (it's the xpaserver(3) page, from the SAORD Documentation, and it's about making YOUR program the one that answers when other programs come knocking 🫶)

---

🦋 SYNOPSIS 🦋

Lowkey just: a whole description of the XPA server-side programming interface. That's it. That's the vibe. ✨

---

👑 DESCRIPTION 👑

🌸 Introduction to XPA Server Programming 🌸

okay so here's the tea: making an XPA server is genuinely easy. Like, usually you only need to call XPANew() to define a named XPA access point and set up your send and receive callback routines, and then you just... enter an event loop like XPAMainLoop() and let it field all the XPA requests coming at you. main character energy, no cap 💅

#include <xpa.h>

XPA XPANew(char *class, char *name, char *help,
    int (*send_callback)(), void *send_data, char *send_mode,
    int (*rec_callback)(),  void *rec_data,  char *rec_mode);

XPA XPACmdNew(char *class, char *name);

XPACmd XPACmdAdd(XPA xpa,
       char *name, char *help,
       int (*send_callback)(), void *send_data, char *send_mode,
       int (*rec_callback)(),  void *rec_data,  char *rec_mode);

void XPACmdDel(XPA xpa, XPACmd cmd);

XPA XPAInfoNew(char *class, char *name,
    int (*info_callback)(), void *info_data, char *info_mode);

int XPAFree(XPA xpa);

void XPAMainLoop(void);

int XPAPoll(int msec, int maxreq);

void XPAAtExit(void);

void XPACleanup(void);

---

🎀 Introduction 🎀

So to actually use the XPA application programming interface, a software developer generally includes the xpa.h definitions file, like:

#include <xpa.h>

...inside the software module that defines or accesses an XPA access point, and then links against the libxpa.a library:

gcc -o foo foo.c libxpa.a

and pookie, listen: XPA has been compiled using both C and C++ compilers. versatile queen 👑

A server program generally defines an XPA access point by calling the XPANew() routine, and it specifies "send" and/or "receive" callback procedures to be executed by the program when an external process either sends data or commands to this access point, or requests data or information from this access point. 🦋

A program also can define several sub-commands for a single access point by calling XPACmdNew() and XPACmdAdd() instead. 😌

Having defined one or more public access points in this way, an XPA server program enters its usual event loop — or uses the standard XPA event loop. Either way, iconic. periodt. 💖

---

🌈 SEE ALSO 🌈

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

---

and that's a wrap, bestie!! this was version 2.1.15, dated July 23, 2013 — like, vintage but still serving 💅✨ go build something cute, ily 🎀