Gamma™ : Version 6.4
	QNX 4

`qnx_vc_name_attach`

qnx_vc_name_attach — attaches a virtual circuit with a name instead of a process ID number.

Syntax

qnx_vc_name_attach (node, max_msg_length, name)

Arguments

node: The node for the attachment.
max_msg_length: The maximum message size which will be passed between tasks.
name: The name of the task to attach.

Returns

Virtual circuit ID on success, -1 on failure, with errno set.

Description

This function performs the same operation as qnx_vc_attach except that a name attached with qnx_name_attach can be specified instead of a process ID number. The function is currently only available in QNX 4.

Possible errno values 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 pid not valid

Example

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


qnx_vc_detach		Index

qnx_vc_name_attach