NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO
#include <blackbox/chBlackBox.h>void bbEvent(const char *name, KnBBPid id, KnBBSeverity sev, char *format, .../* arg */);
The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.
See API(5FEA) for details.
bbEvent() adds an event message to the cyclical buffer of the active black box.
The syntax of bbEvent() is similar to that of printf() with the restriction that the only conversion specifications supported are %x, %s, %d, %p, and %c.
A maximum of BB_MSG_MAX-1 (defined in blackbox/chBlackBox.h) characters of the data will be stored in the black box, after format string expansion.
Process names and tags are limited to BB_PNAME_MAX and BB_TAG_MAX respectively.
The severity parameter is an integer between 0 and 31, indicating the severity of the event. Larger values indicate higher severities.If the given severity is out of range (not between 0 and 31 inclusive), the event will be treated as if it had a severity of 0 (the lowest severity), and will be subject to filtering as such.
The tag parameter is a label for the event, to enable fine-grained filtering.
The id parameter is the PID (Producer ID) of the producer specified. If this is equal to 0, this specifies events coming from the microkernel or supervisor. In this case name is ignored. The name is the name of the producer. This is usually the basename of the first argument that was passed to one of the exec() functions, after traversing any symlinks. This is often the same as argv() for many process.
None.
No errors are defined.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO