NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO
#include <mipc/chMipc.h>int msgSpaceOpen(KnMsgSpaceId spaceGid);
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.
MIPC
The msgSpaceOpen() call assigns a local private identifier associated with the message space opened to the calling actor. It maps the message pools of the message to the calling actor's addressing space.
The spaceGid field is the global identifier of a message space created previously using msgSpaceCreate(2K).
The msgSpaceOpen() call transparently selects the address within the addressing space of the actor at which the set of message pools of the message space are to be mapped.
Upon successful completion, msgSpaceOpen() returns the local identifier of the message space assigned to the actor. Otherwise, a negative error code is returned.
When called multiple times with the same global space identifier (spaceGid), msgSpaceOpen() returns the same local space identifier.
The message space does not exist.
There is insufficient room in the addressing space of the actor to map the message pools of the opened message space.
The system is out of resources. This value is returned, for example, when the system attemps to exceed the limit defined by the tunable kern.mipc.maxOpenSpaceNumber.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO