new event_once interface; start of buffering interface for buffered events

svn:r93

1 files changed, 17 insertions, 0 deletions

diff --git a/event.3 b/event.3
index 924ecdea..0a355cef 100644
--- a/event.3
+++ b/event.3
@@ -36,6 +36,7 @@
 .Nm event_set ,
 .Nm event_add ,
 .Nm event_del ,
+.Nm event_once ,
 .Nm event_pending ,
 .Nm event_initialized ,
 .Nm evtimer_set ,
@@ -65,6 +66,8 @@
 .Ft int
 .Fn "event_del" "struct event *ev"
 .Ft int
+.Fn "event_once" "int fd" "short event" "void (*fn)(int, short, void *)" "void *arg" "struct timeval *tv"
+.Ft int
 .Fn "event_pending" "struct event *ev" "short event" "struct timeval *tv"
 .Ft int
 .Fn "event_initialized" "struct event *ev"
@@ -234,6 +237,20 @@ will cancel the event in the argument
 If the event has already executed or has never been added
 the call will have no effect.
 .Pp
+The function
+.Fn event_once
+is similiar to
+.Fn event_set .
+However, it schedules a callback to be called exactly once and does not
+require the caller to prepare an
+.Fa event
+structure.
+This function supports
+.Fa EV_TIMEOUT ,
+.Fa EV_READ
+and
+.Fa EV_WRITE .
+.Pp
 The
 .Fn event_pending
 function can be used to check if the event specified by