uLan/Universal Light Event Poll Library (ULEVPOLL)

Pavel Pisa

<pisa@cmp.felk.cvut.cz>

The uLevPoll library provides infrastructure to to process system level events in application with well defined and portable triggers register and modification operations.

Table of Contents

1. Event Processing Library Concepts

1.1. The Goals
1.2. Cascading of Event Processing Implementations
1.3. History

2. Functions Description

2.1. Basic Level Public API

struct ul_evptrig_t -- event trigger public structure
struct ul_evpbase_t -- common part of event poll base structure
ul_evptrig_preinit_detached -- mark trigger structure as not initialized yet
ul_evptrig_is_detached -- test if trigger is not initialized/attached to base
ul_evptrig_init -- initialization of event trigger structure
ul_evptrig_done -- detach and done event trigger
ul_evptrig_set_fd -- set file descriptor monitored for specified events
ul_evptrig_set_time -- set absolute time to trigger event
ul_evptrig_set_timeout -- inactivity timeout for trigger event
ul_evptrig_set_callback -- set user calback function for given event trigger
ul_evptrig_arm -- activates trigger to monitor for selected events
ul_evptrig_disarm -- stop monitoring of events by this trigger
ul_evptrig_arm_once -- activates trigger to wait for first of events only
ul_evptrig_set_param -- set extended/system specific parameter
ul_evptrig_get_param -- get extended/system specific parameter
ul_evptrig_get_base -- get pointer to poll base trigger is member of
ul_evpoll_new -- create new event base
ul_evpoll_destroy -- destroy base and inform all attached triggers
ul_evpoll_update -- mostly reserve for some mechanisms requiring update calls
ul_evpoll_dispatch -- start single iteration of the wait and process events cycle
ul_evpoll_get_current_time -- get current time in given base epoch and units
ul_evpoll_loop -- run event loop as long as required
ul_evpoll_quilt_loop -- mark event loop to terminate before next iteration
ul_evpoll_cascade -- cascade base or event triggers attached to it onto another base