X-Git-Url: https://git.ozlabs.org/?a=blobdiff_plain;ds=sidebyside;f=ccan%2Fio%2Fio.h;h=478190f4d05b16def3f7eb481c2c8ecff334ee83;hb=cdf62dce7077a9f9a818edbb67d31d033cbb73c6;hp=ecbeb0b093bf6f0c43054b9a67e1233cff41bf66;hpb=710d42d071a10093077d30d6e521f9599a9bc997;p=ccan

diff --git a/ccan/io/io.h b/ccan/io/io.h
index ecbeb0b0..478190f4 100644
--- a/ccan/io/io.h
+++ b/ccan/io/io.h
@@ -490,6 +490,21 @@ bool io_is_idle(const struct io_conn *conn);
 #define io_break(ret, plan) (io_plan_no_debug(), io_break_((ret), (plan)))
 struct io_plan io_break_(void *ret, struct io_plan plan);
 
+/**
+ * io_never - assert if callback is called.
+ *
+ * Sometimes you want to make it clear that a callback should never happen
+ * (eg. for io_break).  This will assert() if called.
+ *
+ * Example:
+ * static struct io_plan break_out(struct io_conn *conn, void *unused)
+ * {
+ *	// We won't ever return from io_break
+ *	return io_break(conn, io_never());
+ * }
+ */
+struct io_plan io_never(void);
+
 /* FIXME: io_recvfrom/io_sendto */
 
 /**