sam_start3

Usage

Overview

The sam_start function is used to start health checking of application. After calling this function, the active process needs to send healthchecks within the registered time interval by calling sam_hc_send(3). If event driven healthchecking is configured by calling sam_register(3), an internal thread will be created and send health check confirmations four times per time_interval.

Application must be registered by calling sam_register(3) before this function can be called.

An application can always stop health checking by calling the sam_stop(3) function.

If SAM is initialized with quorum policy SAM_RECOVERY_POLICY_QUIT or SAM_RECOVERY_POLICY_RESTART sam_start will block until corosync becomes quorate.

Return value

This call return CS_OK value if successful, otherwise and error is returned. If SAM is initialized with quorum policy, returned error can also be quorum error.

Errors

CS_ERR_BAD_HANDLE

component was not registered by calling sam_register(3) function.