IXP_LISTEN(3)

💖 IXP_LISTEN(3) 💖

okay so bestie, welcome to the Library Functions Manual corner of the group chat — this one is literally IXP_LISTEN(3), and it's giving “let's start a server listening sitch” energy. no cap. 💅

🌸 NAME 🌸

ixp_listen, IxpConn — the listen-y function and the connection struct it hands you back. slay. ✨

✨ SYNOPSIS ✨

#include <ixp.h>

IxpConn *ixp_listen(IxpServer *srv, int fd, void *aux, void (*read)(IxpConn *), void (*close)(IxpConn *));

typedef struct IxpConn IxpConn;
struct IxpConn {
        IxpServer*      srv;
        void*           aux;    /* Arbitrary pointer, to be used by handlers. */
        int             fd;     /* The file descriptor of the connection. */
        void            (*read)(IxpConn *);
        void            (*close)(IxpConn *);
        char            closed; /* Non-zero when fd has been closed. */

        /* Private members */
        ...
}

🎀 PARAMETERS 🎀

• fs — the file descriptor on which to listen. yes bestie, that's the exact name in this list; the synopsis says fd, so iykyk. 💅
• aux — a piece of data to store in the connection's aux member of the IxpConn data structure. cute little stash spot for your handlers.
• read — the function called when the connection has data available to read. it's giving “hey bestie, there's stuff to read” energy. 📖
• close — a cleanup function called when the connection is closed. self-care for your connection. 🧚

🦋 DESCRIPTION 🦋

Starts the server srv listening on fd. The optional read and close callbacks are called with the IxpConn structure for the connection as their sole argument. that's literally it, bestie — main character server-loop behavior, no extra lore. ✨

🌈 RETURN VALUE 🌈

Returns the connection's new IxpConn data structure. so you get a fresh little connection struct back — obsessed. 💖

🔥 SEE ALSO 🔥

• ixp_serverloop(3)
• ixp_serve9conn(3)
• ixp_hangup(3)

go read these next, bestie 🫶

and that's the whole vibe 💜 — this page comes from the libixp Manual, dated 2012 Dec, and it's literally IXP_LISTEN(3). periodt. 💅