NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | RETURN VALUE | ERRORS | RESTRICTIONS | ATTRIBUTES | SEE ALSO
#include <ipc/chIpc.h>int ipcSysInfo(KnMsgHead *msghead);
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.
IPC
The ipcSysInfo call returns system information about the current message received. The msghead field points to a KnMsgHead structure whose members are the following:
int bodySize ; /* Body size */ char flags [4] ; /* Flags */ KnUniqueId srcPort ; /* source port */ KnUniqueId target ; /* destination port or group */ KnUniqueId coTarget ; /* site qualifier */ KnTransId transId ; /* message transaction id. */ KnProtId actorId ; /* sender actor protection id. */ KnProtId portId ; /* source port protection id. */ |
The bodySize field is the size of the message body.
The srcPort field is the unique identifier of the source port of the message.
The target and coTarget parameters specified the destination when the message was sent (see ipcSend(2K) and ipcCall(2K)).
The transId field is the transaction identifier of the message.
The protection identifier of the actor originating the message is specified using actorId.
The protection identifier of the source port of the message is specified using portId.
Note that ipcReply(2K) does not affect the source port, the protection identifiers and the transaction identifier of a message.
Upon successful completion a value of 0 is returned. Otherwise, a negative error code is returned.
There is no current message (no message has been received by the current thread since the last ipcReply(2K) or ipcSave(2K)).
Some of the data provided are outside the current actor's address space.
The fields flags and transId are obsolete and are never set by the microkernel.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | RETURN VALUE | ERRORS | RESTRICTIONS | ATTRIBUTES | SEE ALSO