NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO
#include <blackbox/chBlackBox.h>int bbOpen(const KnCap*cap, KnBBId id, void** hdl);
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.
bbOpen() obtains access to a frozen black boxid, for the actor whose capability is given by cap. If cap is K_MYACTOR, the operation is applied to the current actor.
id is the ID of the black box to open, for example, as obtained by calling bbFreeze()or bbList().
hdl is the returned opaque object (similar to, but not necessarily equivalent to, a file descriptor) that can be used to read events from the given black box with bbRead(). When done reading the black box, the object should be passed to bbClose().
bbOpen() returns BB_INVALID_HANDLE on failure, and a value of 0 on success.
cap is an inconsistent actor capability or id is an ivalid black box ID
cap does not specify a reachable actor
he specified black box is not frozen
The specified black box is already opened by someone else
Some of the provided data are 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