ham_stop()

QNX SDP8.0High Availability Framework Developer's GuideDeveloper

Stop the HAM

Synopsis:

#include <ha/ham.h>

int ham_stop( void );

Library:

libham

Description:

The ham_stop() function instructs the HAM to terminate. This is the only proper way to stop the HAM.

Since the HAM and its clone the Guardian monitor each other, and re-spawn should the other fail, the HAM must first terminate the Guardian before it terminates itself.

Returns:

0
Success.
-1
An error occurred (errno is set).

Errors:

EBADF
Couldn't connect to the HAM.

In addition to the above, the HAM returns any error it encounters while servicing the request to terminate.

Classification:

QNX OS

Safety:
Cancellation pointNo
Signal handlerNo
ThreadYes
Page updated: