From 62ae071233b89e353d3865b1d1aa74eea7d319fb Mon Sep 17 00:00:00 2001 From: Thomas Harning Jr Date: Tue, 20 Nov 2007 18:03:53 -0500 Subject: docs: Added remaining documentation for luaevent.core --- doc/modules/luaevent.core.mdwn | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) (limited to 'doc/modules') diff --git a/doc/modules/luaevent.core.mdwn b/doc/modules/luaevent.core.mdwn index c5fa086..6c7b112 100644 --- a/doc/modules/luaevent.core.mdwn +++ b/doc/modules/luaevent.core.mdwn @@ -23,12 +23,45 @@ Constants: For example: `EV_READ` | `EV_TIMEOUT` means that a timeout occurred while waiting for a read event. * `EVBUFFER_READ` + * Marks that the input buffer has data available > low watermark * `EVBUFFER_WRITE` + * Marks that the output buffer level is below low watermark * `EVBUFFER_EOF` + * Received tagged with either read/write based on location received in the error callback * `EVBUFFER_ERROR` + * An error occurred (tagged w/ either read/write) and the error is in `errno` * `EVBUFFER_TIMEOUT` + * A timeout occurred (tagged w/ either read/write) Functions: [[toc levels=1]] +## luaevent.core.new +* Allocates a new event 'core' (`event base`) + +## event_callback fn +* Input: `(event)` +* Output: `(newEvent, [newTimeout])` + * `newEvent` - New event to register, typically `LEAVE`, `EV_READ`, `EV_WRITE`, or `EV_READ`|`EV_WRITE` + * `newTimeout` - New timeout value to use + +## core:addevent +* Adds a new event to the eventloop +* Input: `(fd, event, event_callback, [timeout])` + * `fd` - File descriptor to read from / or NIL for pure timeout event + * `event` - `EV_*` flagset to mark what events to capture + * `EV_SIGNAL` and `EV_PERSIST` is unavailable currently + * `EV_PERSIST` is used internally. + * `event_callback` - Callback to call... (see above) + * `timeout` - Time in seconds to timeout (decimal values supported) +* Output: `event_callback` object + * Has a `close` and `__gc` FN which will erase the callback, + so preserve this until done. + +## core:loop +* Begins the event loop and doesn't return until there are no events left + +## core:close (__gc) +* Closes the event base +* Do not allow this to be called while `core:loop` is running -- cgit v1.2.3