NAME | SYNOPSIS | FEATURES | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES | SEE ALSO
#include <ipc/chIpc.h>int ipcTarget(KnUniqueId *groupui, int mode);
IPC
ipcTarget builds a message destination using the port group unique identifier given by groupui and the addressing mode mode. It affects the port group identifier given by groupui. This identifier may then be used as a target for sending messages by ipcSend(2K) or ipcCall(2K).
The following addressing modes are possible:
The message will be sent to each reachable member of the group (ie. ports which have been inserted in the group - see grpPortInsert(2K)).
The message will be sent to one of the reachable members of the group.
Tthe message will be sent to one of the reachable members of the group which resides on the site qualified by the coTarget member specified at send time (see ipcSend(2K)).
The message will be sent to one of the reachable members of the group, assuming that the UI of this member must be different from the UI given by the coTarget member specified at send time (see ipcSend(2K)).
A port group name may be used directly as a message target, without applying ipcTarget(2K) on it. In that case, the default addressing mode K_BROADMODE is used.
Upon successful completion a value of 0 is returned. Otherwise, a negative error code is returned.
groupui is not a port group name, or mode is not a valid addressing mode.
Some of the provided data are outside the current actor's address space.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
NAME | SYNOPSIS | FEATURES | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES | SEE ALSO