syseventOpen(3EXT)

NAME | SYNOPSIS | API RESTRICTIONS | PARAMETERS | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES | SEE ALSO

NAME

syseventOpen- bind a sysevent space

SYNOPSIS

$(NUCLEUS_DIR)/lib/sysevent/sysevent.a
#include <sysevent/chSysevent.h>

int syseventOpen(KnSyseventParm *parm, int *spaceId);

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.

PARAMETERS

parm

Address of a KnSyseventParm structure holding the configuration settings.

spaceId

Address of an integer to receive the event space handle

DESCRIPTION

The syseventOpen() function binds an existing system event space. In most cases, this event space was previously created by another actor that invoked syseventCreate(). The event space to open is named by the global event space identifier held by the parm structure. The event space ID is the only field of the parm structure which is used by syseventOpen().

If creation succeeds, an event space handle is copied to the location pointed to by spaceId. The caller can then interact with all the other entities bound to the same event space, via the sysevent framework.

RETURN VALUE

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

ERRORS

[K_EINVAL]

An event space with the same global ID already exists

[K_EOVERLAP]

No sufficient addressing space to map the event pools

[K_EARGS]

Some of the configuration settings are incorrect

[K_ADDR]

One of the parameters has a null value

[K_ENOMEM]

Cannot allocate the memory needed to create the event space

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

SEE ALSO

syseventCreate(3EXT), syseventInit(3EXT), syseventGetConf(3EXT)

ChorusOS 5.0  Last Revised December 2001

NAME | SYNOPSIS | API RESTRICTIONS | PARAMETERS | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES | SEE ALSO