NAME¶

iom_init - create new I/O multiplexer

SYNTAX¶

#include <libowfat/io.h>

int iom_init(iomux_t* c);

DESCRIPTION¶

iom_init initializes an I/O multiplexer.

An I/O multiplexer is a context that can be used to do I/O multiplexing with support for multiple threads. Add events to a multiplexer using iom_add, and then get the next available event with iom_wait. If you are done and want to signal all the threads something, set a volatile global variable to tell the threads to stop and then fall iom_abort to tell all pending iom_wait operations in all threads to return immediately.

After iom_init is done, iom_add and iom_wait can be called from different threads on the same context, and they will synchronize internally.

LINKING¶

You may have to add -lpthread to the command line in the linking step.

RETURN VALUE¶

iom_init returns 0 on success and -1 on error, setting errno.

SEE ALSO¶

iom_add, iom_wait, iom_abort