ham_entity_condition_raise()

Used by an entity to raise a condition

Synopsis:

#include <ha/ham.h>

int ham_entity_condition_raise(
                         ham_entity_t *ehdl,
                         unsigned rtype,
                         unsigned rclass,
                         unsigned rseverity,
                         unsigned flags );

Library:

libham

Description:

This function is used by an entity to notify a HAM of an interesting event of its choice. This in turn triggers a CONDITION_RAISE in the HAM, which will search for matching subscribers for this event and execute all associated actions.

The values of rtype, rclass, and rseverity can be used to permit finer grain matching and to gather additional information relating to the condition.

To learn more about the matching mechanism, refer to the API documentation for ham_condition_raise().

Returns:

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

Errors:

EBADF
Couldn't connect to the HAM.
EINVAL
The handle specified in ehdl is invalid.

The connection to the HAM is invalid. This happens when the process that opened the connection (using ham_connect()) and the process that's calling this function are not the same.

ENOENT
There's no entity by the given handle (ehdl).

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

Classification:

QNX Neutrino

Safety:
Cancellation point No
Interrupt handler No
Signal handler No
Thread Yes

See also:

ham_condition(), ham_condition_raise(), ham_condition_state(), ham_attach() ham_attach_self() ham_entity() ham_entity_control() ham_entity_handle() ham_entity_handle_free() ham_entity_node()