qnx_vc_attach
qnx_vc_attach — establishes a virtual circuit between two processes on two computers.
Syntax
qnx_vc_attach (node, taskid, max_msg_length, flags)
Arguments
- node
- The node to which to attach.
- taskid
- The task id to which to attach.
- max_msg_length
- The maximum message size which will be passed between tasks.
- flags
- Virtual circuit flags.
Returns
A task id of a virtual circuit, or -1 on error, with errno set.
Description
This function establishes a network link between two processes on two computers. Once this link is established the two processes can communicate using the IPC function qnx_send/qnx_receive/qnx_reply.
Legal virtual circuit flags that can be OR-ed together are:
- 0 (zero) A new virtual process and a new buffer will be allocated on both ends.
- _VC_AT_SHARE Use an existing virtual circuit, if it exists.
- _VC_AT_REM_ZOMBIE The remote virtual circuit id (vid) will become a zombie process when the remote process ID terminates.
Possible values for errno are:
- EAGAIN Proc to Net enqueuing failed
- EHOSTUNREACH Destination node not in netmap or physical I/O error
- EINVAL buffer too big
- ENOLIC no license to communicate with this node
- ENOMEM not enough memory to complete operation
- ENOVPE not enough proc entries to new vc
- ENOSYS no Net manager found
- ESRCH process ID not valid
Example
Examples of this function are beyond the scope of this documentation.
