prelude-connection-pool
Pool of connection handling
This API handle pool of connection, allowing to address a set of connection using only one object.
AND & OR of connection are supported, so that it is possible to
address several connection at once, or to only address a set of connection
if another connection went down.
Additionally it provide failover in case one of the connection in
the pool goes down, and automatic reconnection and flushing of the
information that could not be sent due to the connection status.
It is usually not necessary to access this API directly, however if
you are looking at how to read events from a pool of connection, you're most
probably looking for the prelude_connection_pool_check_event() function.
If this is the case, use prelude_connection_pool_check_event() for polling the
pool or prelude_connection_set_event_handler() / prelude_connection_set_global_event_handler()
if you want asynchronous notification of event.
Note that prelude_connection_set_event_handler() and prelude_connection_set_global_event_handler()
are only asynchronous if timer are running in asynchronous mode. Otherwise, the callback for theses
function might be called when you call the prelude_timer_wake_up() function.
In the provided callback, you might use prelude_connection_recv() to retrieve an event of type
#PRELUDE_CONNECTION_POOL_EVENT_INPUT. And, you could, for example, if the retrieved message has
the #PRELUDE_MSG_ID_IDMEF tag, provide the returned #prelude_msg_t object to idmef_message_read()
in order to convert the received message to a #idmef_message_t object.
#prelude_connection_t
idmef_message_read()
@PRELUDE_CONNECTION_POOL_FLAGS_RECONNECT:
@PRELUDE_CONNECTION_POOL_FLAGS_FAILOVER:
@PRELUDE_CONNECTION_POOL_EVENT_INPUT:
@PRELUDE_CONNECTION_POOL_EVENT_DEAD:
@PRELUDE_CONNECTION_POOL_EVENT_ALIVE:
@pool:
@msg:
@pool:
@msg:
@pool:
@Returns:
@ret:
@cp:
@permission:
@Returns:
@pool:
@Returns:
@pool:
@cnx:
@Returns:
@pool:
@cnx:
@Returns:
@pool:
@cnx:
@Returns:
@pool:
@cfgstr:
@Returns:
@pool:
@Returns:
@pool:
@pool:
@Returns:
@pool:
@flags:
@pool:
@req_perm:
@pool:
@data:
@pool:
@Returns:
@pool:
@timeout:
@outconn:
@outmsg:
@Returns:
@pool:
@timeout:
@event_cb:
@extra:
@Returns:
@pool:
@wanted_events:
@callback:
@pool:
@wanted_events:
@callback: