ham_detach_name()

QNX SDP8.0High Availability Framework Developer's GuideDeveloper

Detach an entity from the HAM, using an entity name

Synopsis:

#include <ha/ham.h>

int ham_detach_name( int reserved,
                     const char *ename, 
                     unsigned flags);

Arguments:

reserved
Set this argument to 0.
ename
The name of the entity to detach.
flags
Currently not used.

Library:

libham

Description:

This function detaches an attached entity (ename) from a HAM. The entity being detached must NOT be a self-attached entity.

There are no flags defined at this time.

This function automatically calls ham_connect() and ham_disconnect() for the client.

Returns:

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

Errors:

EBADF
Error connecting to the HAM.
EINVAL
The name passed as an argument is invalid.
ENOENT
There's no entity corresponding to the name supplied.

In addition to the above errors, the HAM returns any error it encounters while servicing the request to remove the entity from its context.

Classification:

QNX OS

Safety:
Cancellation pointNo
Signal handlerNo
ThreadYes
Page updated: