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:

Example

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

See Also

qnx_trigger qnx_rem_proxy_detach

Copyright 1995-2002 by Cogent Real-Time Systems, Inc.