NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO
#include <blackbox/chBlackBox.h>int bbFreeze(KnBBId * id);
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.
bbFreeze() freezes the currently active black box, and directs all future events to another black box (if available).
The id returned is the index of the newly frozen black box. This integer can subsequently be passed to bbOpen() to access the contents of this black box's buffer.
Upon successful completion a value of 0 is returned. Otherwise, a negative error code is returned.
id is an invalid blackbox identifier
No active black boxes available
The id provided is outside the caller's address space
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