qnx_proxy_rem_attach

Gamma: Version 4.0
Prev |  | Next

# `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.

## See Also

`qnx_trigger` `qnx_rem_proxy_detach`

Prev | Home | Next
`qnx_proxy_detach` | Up | `qnx_proxy_rem_detach`

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