Used by an entity to raise a condition
#include <ha/ham.h> int ham_entity_condition_raise( ham_entity_t *ehdl, unsigned rtype, unsigned rclass, unsigned rseverity, unsigned flags );
libham
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().
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.
In addition to the above errors, the HAM returns any error it encounters while servicing this request.
Safety: | |
---|---|
Cancellation point | No |
Interrupt handler | No |
Signal handler | No |
Thread | Yes |