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.

See Also

qnx_vc_attach, qnx_vc_detach