bbReset(2K)

NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO

NAME

bbReset- resets a frozen black box

SYNOPSIS

#include <BlackBox/chBlackBox.h>

int bbReset(KnBBId id);

API RESTRICTIONS

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.

DESCRIPTION

bbReset() resets a frozen black box.

The contents of the buffer are totally erased. Call bbRelease() to release the given buffer.

id is the ID of the black box to open, for example, as obtained by calling bbFreeze() or bbList().

RETURN VALUES

Upon successful completion K_OK is returned. Otherwise, a negative error code is returned.

ERRORS

[K_EINVAL]:

id is not a valid blackbox ID

[K_EFAIL]:

The buffer is either open or not frozen

[K_EPRIV]:

The caller is neither a supervisor actor nor a system actor

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

SEE ALSO

bbFreeze(2K)

bbList(2K)

ChorusOS 5.0  Last Revised December 2001

NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO