readd include dir

include/iomux.h

@@ -0,0 +1,97 @@
+#ifndef IO_MUX_H_
+#define IO_MUX_H_
+
+#include "ucore_timers.h"
+
+#define MUX_EV_READ    (1 << 0x00)
+#define MUX_EV_WRITE   (1 << 0x01)
+//#define MUX_EV_EXCEPT  (1 << 0x02)
+#define MUX_EV_MASK (MUX_EV_READ | MUX_EV_WRITE )
+
+/** 
+ * mux implementation to use
+*/
+enum IOMUX_TYPE {
+    IOMUX_TYPE_DEFAULT = 0,
+    IOMUX_TYPE_SELECT,
+    IOMUX_TYPE_EPOLL
+};
+
+/** Opaque struct */
+struct IOMux;
+struct IOMuxFD;
+typedef void (*iomux_cb)(struct IOMux *mux, struct IOMuxFD *fd, unsigned int event);
+
+/** Represents a watched file descriptor */
+struct IOMuxFD {
+    /** The file descriptor */
+    int fd;
+    /** The events to watch for, MUX_EV_XX mask */
+    unsigned int what;
+    /** callback to call on an event */
+    iomux_cb callback;
+    /** values available to the caller. These will bbe passed
+     * back on the callback */
+    void *cookie_ptr;
+    int cookie_int;
+    int cookie_int2;
+};
+
+/** Creates a new IOMux. 
+ */
+struct IOMux *iomux_create(enum IOMUX_TYPE type);
+
+/** Deletes the IOMux and frees its resources.
+ * Can not be called from within a callback */
+void iomux_delete(struct IOMux *mux);
+
+/** Runs the event loop of the mux
+ * returns if the number of file descriptors and timers are 0 or 
+ * an error occurs */
+int iomux_run(struct IOMux *mux);
+
+/* Adds a file descriptor to the watch set,
+ * returns 0 on success, an errno value on error */
+int iomux_register_fd(struct IOMux *mux, struct IOMuxFD *fd);
+
+/** Removes the file descriptor*/
+int iomux_unregister_fd(struct IOMux *mux, struct IOMuxFD *fd);
+
+/** Updates the events to watch for in fd->what
+ * returns 0 on success, an errno value on error */
+int iomux_update_events(struct IOMux *mux, struct IOMuxFD *fd);
+
+
+/**
+ * Convenience macro for setting the new event
+ */
+#define iomux_set_event(mux, fd, what)\
+({\
+    (fd)->what = (what);\
+    iomux_update_events((mux), (fd));\
+})
+
+/**
+ * Convenience macro for clearing the new event
+ */
+#define iomux_clear_event(mux, fd, what)\
+({\
+    (fd)->what &= ~(what);\
+    iomux_update_events((mux), (fd));\
+})
+/**
+ * Convenience macro for adding the new event to the existing events
+ */
+#define iomux_add_event(mux, fd, what)\
+({\
+    (fd)->what &= (what);\
+    iomux_update_events((mux), (fd));\
+})
+
+/** Returns a UCTimer instance tied to this mux.
+ *  Used to schedule timers within this mux.
+ */
+struct UCTimers *iomux_get_timers(struct IOMux *mux);
+
+#endif
+