bb_open(3EXT)

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

NAME

bb_open- open a frozen black box

SYNOPSIS

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

bb_handle_t bb_open(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 open, for example, as obtained by calling bb_list()

DESCRIPTION

bb_open() obtains access to a frozen black box.

bb_open() returns an 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 bb_read(). When done reading the black box, the object should be passed to bb_close().

Black box handles are inherited by the child on calls to fork() or fork1() and are closed on exec().

A handle opened by one thread in a process is accessible to all other threads in that process. Upon process exit, all open black box handles are closed.

RETURN VALUES

bb_open() returns BB_INVALID_HANDLE on failure, and a valid handle on success.

ERRORS

If it returns BB_INVALID_HANDLE, errno is set to:

ENOENT

There is no black box with the specified ID

EBUSY

The specified black box is not frozen

EMFILE

Too many calls to bb_open() from this process

EFULL

The black box is full.

EPERM

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

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

SEE ALSO

bb_close(3EXT), bb_read(3EXT), bb_list(3EXT), fork(2POSIX), exec(3POSIX)

ChorusOS 5.0  Last Revised December 2001

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