qnx_vc_name_attach

Gamma: Version 4.0
Prev |  | Next

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

Prev | Home | Next
`qnx_vc_detach` | Up | Index

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