Gamma™ : Version 7.2
	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