]> git.ozlabs.org Git - ccan/blobdiff - ccan/io/backend.h
io: use normal linked lists.
[ccan] / ccan / io / backend.h
index 2b41fa72864ca1df0ac16b2afa023e2cfcd1856c..3a1f12e7ee859742b0341912de41044c5416b61b 100644 (file)
@@ -1,79 +1,75 @@
-/* Licensed under BSD-MIT - see LICENSE file for details */
+/* Licensed under LGPLv2.1+ - see LICENSE file for details */
 #ifndef CCAN_IO_BACKEND_H
 #define CCAN_IO_BACKEND_H
 #include <stdbool.h>
+#include <poll.h>
+#include "io_plan.h"
+#include <ccan/list/list.h>
 
 struct fd {
        int fd;
        bool listener;
        size_t backend_info;
-
-       struct io_op *(*next)(struct io_conn *, void *arg);
-       void *next_arg;
-
-       void (*finish)(struct io_conn *, void *arg);
-       void *finish_arg;
 };
 
-
 /* Listeners create connections. */
 struct io_listener {
        struct fd fd;
-};
 
-enum io_state {
-       /* These wait for something to input */
-       READ,
-       READPART,
+       const tal_t *ctx;
 
-       /* These wait for room to output */
-       WRITE,
-       WRITEPART,
-
-       NEXT, /* eg starting, woken from idle, return from io_break. */
-       IDLE,
-       FINISHED,
-       PROCESSING /* We expect them to change this now. */
+       /* These are for connections we create. */
+       struct io_plan *(*init)(struct io_conn *conn, void *arg);
+       void *arg;
 };
 
-static inline enum io_state from_ioop(struct io_op *op)
-{
-       return (enum io_state)(long)op;
-}
-
-struct io_state_read {
-       char *buf;
-       size_t len;
+enum io_plan_status {
+       /* As before calling next function. */
+       IO_UNSET,
+       /* Normal. */
+       IO_POLLING,
+       /* Waiting for io_wake */
+       IO_WAITING,
+       /* Always do this. */
+       IO_ALWAYS,
+       /* Closing (both plans will be the same). */
+       IO_CLOSING
 };
 
-struct io_state_write {
-       const char *buf;
-       size_t len;
-};
-
-struct io_state_readpart {
-       char *buf;
-       size_t *lenp;
-};
+/**
+ * struct io_plan - one half of I/O to do
+ * @status: the status of this plan.
+ * @io: function to call when fd becomes read/writable, returns 0 to be
+ *      called again, 1 if it's finished, and -1 on error (fd will be closed)
+ * @next: the next function which is called if io returns 1.
+ * @next_arg: the argument to @next
+ * @u1, @u2: scratch space for @io.
+ */
+struct io_plan {
+       enum io_plan_status status;
+
+       int (*io)(int fd, struct io_plan_arg *arg);
+
+       struct io_plan *(*next)(struct io_conn *, void *next_arg);
+       void *next_arg;
 
-struct io_state_writepart {
-       const char *buf;
-       size_t *lenp;
+       struct io_plan_arg arg;
 };
 
 /* One connection per client. */
 struct io_conn {
        struct fd fd;
+       bool debug;
+       /* For duplex to save. */
+       bool debug_saved;
 
-       struct io_conn *duplex;
+       /* always and closing lists. */
+       struct list_node always, closing;
 
-       enum io_state state;
-       union {
-               struct io_state_read read;
-               struct io_state_write write;
-               struct io_state_readpart readpart;
-               struct io_state_writepart writepart;
-       } u;
+       void (*finish)(struct io_conn *, void *arg);
+       void *finish_arg;
+
+       struct io_plan plan[2];
 };
 
 extern void *io_loop_return;
@@ -82,7 +78,17 @@ bool add_listener(struct io_listener *l);
 bool add_conn(struct io_conn *c);
 bool add_duplex(struct io_conn *c);
 void del_listener(struct io_listener *l);
-void backend_set_state(struct io_conn *conn, struct io_op *op);
-
-struct io_op *do_ready(struct io_conn *conn);
+void backend_new_closing(struct io_conn *conn);
+void backend_new_always(struct io_conn *conn);
+void backend_new_plan(struct io_conn *conn);
+void remove_from_always(struct io_conn *conn);
+void backend_plan_done(struct io_conn *conn);
+
+void backend_wake(const void *wait);
+void backend_del_conn(struct io_conn *conn);
+
+void io_ready(struct io_conn *conn, int pollflags);
+void io_do_always(struct io_conn *conn);
+void io_do_wakeup(struct io_conn *conn, enum io_direction dir);
+void *do_io_loop(struct io_conn **ready);
 #endif /* CCAN_IO_BACKEND_H */