Gamma™ : Version 6.4
	QNX 4

`qnx_proxy_rem_attach`

qnx_proxy_rem_attach — creates a remote proxy message for a task.

Syntax

qnx_proxy_rem_attach (node, proxyid)

Arguments

node: The node ID of the remote node.
proxyid: The proxy ID of the associated proxy.

Returns

The remote proxy ID number, else -1.

Description

This function creates and attaches a remote message proxy to task. The task must already have a local proxy, which the remote proxy is associated with.

The remote proxy is activated by a call to qnx_trigger by any task on its node. A call to qnx_trigger on the remote proxy causes a subsequent call to qnx_trigger on its associated local proxy. The receiving task sees no difference between a message from a local proxy or a remote proxy.

If the task's own node number or zero is specified for node, a local proxy is created instead of a remote proxy.

In case of error, the following errnos are possible:

EINVAL Invalid proxy.

EPERM Proxy does not belong to task specified.

ESRCH Proxy does not exist.

Example

Examples of this function are beyond the scope of this documentation.


qnx_proxy_detach		qnx_proxy_rem_detach

qnx_proxy_rem_attach