Query: evs_initialize
OS: debian
Section: 3
Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
EVS_INITIALIZE(3) Corosync Cluster Engine Programmer's Manual EVS_INITIALIZE(3)NAMEevs_initialize - Create a new connection to the EVS serviceSYNOPSIS#include <corosync/evs.h> int evs_initialize(evs_handle_t *handle, evs_callbacks_t *callbacks);DESCRIPTIONThe evs_initialize function is used to initialize a connection to the extended virtual synchrony API. Each application may have several connections to the EVS API. Each application uses the handle argument to uniquely identify the connec- tion. The handle argument is then used in other function calls to identify the connection to be used for communication with the EVS ser- vice. Every time an EVS event occurs, one of the callbacks specified by the argument callbacks is called. The callback functions are described by the following type definitions: typedef void (*evs_deliver_fn_t) ( unsigned int nodeid, const void *msg, size_t msg_len); typedef void (*evs_confchg_fn_t) ( unsigned int *member_list, size_t member_list_entries, unsigned int *left_list, size_t left_list_entries, unsigned int *joined_list, size_t joined_list_entries); The callbacks argument is of the type: typedef struct { evs_deliver_fn_t evs_deliver_fn; evs_confchg_fn_t evs_confchg_fn; } evs_callbacks_t; When a configuration change occurs or a message is to be delivered one of the callbacks is called from the evs_dispatch() function. If a configuration change occurs, evs_confchg_fn is called. If a delivery of a message occurs, evs_deliver_fn is called.RETURN VALUEThis call returns the EVS_OK value if successful, otherwise an error is returned.ERRORSThe errors are undocumented.SEE ALSOevs_overview(8), evs_finalize(3), evs_fd_get(3), evs_dispatch(3), evs_join(3), evs_leave(3), evs_mcast_joined(3), evs_mcast_groups(3), evs_mmembership_get(3) evs_context_get(3) evs_context_set(3) corosync Man Page 2004-08-31 EVS_INITIALIZE(3)