bb_release(3EXT)

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

NAME

bb_release- free up a frozen black box

SYNOPSIS

$(OS_DIR)/lib/libblackbox.a
#include <sys/blackbox.h>

int bb_release(bb_id_t 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.

ARGUMENTS

id(IN):

The ID of the black box to release, for example, as obtained by calling bb_list()

DESCRIPTION

bb_release() frees up a frozen black box.

Once a black box has been released by bb_release(), it is no longer available for "opening" with bb_open(); the data from that black box is no longer accessible.

If the call to bb_release() results in a black box becoming available for taking new events where there were previously none, the black box service will publish a "space available" event via the publish/subscribe mechanism.

RETURN VALUES

bb_release() returns 0 on success and -1 on failure.

ERRORS

If it returns -1, errno is set to:

ENOENT:

There is no black box with the specified ID

EBUSY:

The specified black box is already open for reading, or the specified black box is not frozen

EPERM:

The caller doesn't have permission to release a black box

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

SEE ALSO

bb_open(3EXT)

ChorusOS 5.0  Last Revised December 2001

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