NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO
#include <blackbox/chBlackBox.h>int bbName(KnBBId id, char *oldname, char *newname);
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.
The actorName() call gets or sets, or gets and sets, the symbolic name of the blackbox whose buffer ID is given by id (see bbList()).
If oldname is not NULL, the blackbox's symbolic name is copied to the caller address space specified by oldname. A blackbox symbolic name has a maximum size of BB_STNAME_MAX (including the NULL character).
If newname is not NULL, the blackbox's symbolic name is set to the new name pointed to by newname in the caller address space. The new name is truncated to a maximum size of BB_STNAME_MAX (including the NULL character).
Upon successful completion a value of 0 is returned. Otherwise, a negative error code is returned.
id is an inconsistent blackbox identifier
Some of the data provided are outside the caller's address space.
newname is longer than expected
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