This is a library that applications can use to connect to the Application Heartbeat Service.
-lappHeartbeatMonitor to the compiler options and include appHeartbeatMonitor.h in the source.
There are four functions the client application must call:
This method registers the application with the heartbeat monitor. This method should be called when the application is ready to begin being monitored. After this method is called, if the application exits without unregistering, the heartbeat monitor will attempt to recover it.
Upon return from this call, the client may safely exit without the possibility of being recovered by the heartbeat monitor. Shutdown should still be called in order to free the private data maintained for the application.
This method frees the structure that contains the client registration information and other internal information.
Use of the first three of these functions limits the number of heartbeats a client can produce to only one heartbeat. If your application would like to send multiple heartbeats, it should either implement its own heartbeat function using the FIFO descriptor returned from the ahm_initialize() function or use the ahm_send_heartbeat_to_fifo() function.
This is the companion function to ahm_add_heartbeat_timer_callback. It removes the signal handler and turns off the timer generating those signals.
This function may be used by an application to send a single heartbeat. The client may desire to incorporate this call within its main event loop, but ensuring that it is called with enough frequency that the application doesn't miss a heartbeat.
This function is used to send a heartbeat to a specific FIFO. It is identical to ahm_send_heartbeat with this one exception.