Insert a log message into the activity log of the HAM
#include <ha/ham.h> ham_action_t *ham_action_log( ham_condition_t *chdl, const char *aname, const char *msg, unsigned attachprefix, int verbosity, unsigned flags);
libham
You can use the ham_action_log() function to insert log messages into the activity log stream that the HAM maintains.
The handle (chdl) is obtained either:
or:
The log message to be inserted is specified by msg, and will be generated if the verbosity of the HAM is greater than or equal to the value specified in verbosity. Also, if attachprefix is non-zero, a prefix will be added to the log message that contains the current entity/condition/action that this message is related to.
The following flag is currently defined:
A valid handle to an action to a condition, or NULL if an error occurred (errno is set).
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 ham_action_restart() aren't 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 |