iom_add3
Add event to i/o multiplexer
Usage
#include <libowfat/io.h>
int iom_add(iomux_t* c, int64 fd, unsigned int events);
Overview
iom_add adds an event you are interested in to an I/O multiplexer.
fd is the file descriptor (usually a socket) you are interested in, and events is the operation you want to do. It can be IOM_READ or IOM_WRITE.
If that operation becomes possible on that descriptor, and some thread is calling iom_wait at the time, it will return and tell you the fd and the event.
Note that the event registration is removed from the iomux_t context if it occurs. You will have to call iom_wait again after you handled the event, if you are still interested in it.
Closing a file descriptor with registered events will discard the event registration.
Linking
You may have to add -lpthread to the command line in the linking step.
Return value
iom_add returns 0 on success and -1 on error, setting errno.
Releases
Unchanged in 2 releases since Debian 12 (Bookworm).