mtcp_alloc_event - define a follow-up event for a filter that can trigger multiple (child) events #include <mos_api.h> "event_t mtcp_alloc_event(event_t " parent_event ); mtcp_alloc_event () allocates a new child event that can be triggered by a filter. On success, it returns a child event that can be triggered inside the filter functions registered on "parent_event" . This function allows a single filter to trigger a set of multiple child events based on the processing result inside the filter function. More specifically, a user can call this function to pre-allocate a child user-defined event when initializing mOS events, providing its parent event "parent_event" . When the parent event is triggered, the filter functions registered to the parent event are triggered. The filter function, based on its result, can trigger the child event created with "mtcp_alloc_event () " using the "mtcp_raise_event () " function. """""""""""""""""""""""""""""""""""""""""""""""""""""""""""
Returns "event_t" on success; "MOS_NULL_EVENT" on failure. """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
"""".SH CONFORMING TO
""""POSIX.1-2001.
""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

15 This function returns "MOS_NULL_EVENT" when the given "parent_event" is not defined or cannot allocate more "event_t" structure. """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

mOS development team <[email protected]> """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
mtcp_raise_event (), mtcp_define_event () """""""""""""""""""""""""""""""""""""""""""""""""""""
This page is part of mOS release 0.3 "docs" section. A description of the project, and information about reporting bugs, can be found at \%http://mos.kaist.edu/. """""""""""""""""""""""""""""""""""""""""""""""""""""