qnx_name_locate

Gamma: Version 4.0
Prev |  | Next

# `qnx_name_locate`

`qnx_name_locate` -- is an implementation of the C function `qnx_name_locate`.

## Syntax

    qnx_name_locate (node, name, size)

## Arguments

`node`

  The node on which to locate the name, or 0 for global name service.

`name`

  The name to locate.

`size`

  The initial size of a virtual circuit buffer, if necessary.

## Returns

A list of the form (taskid . number_of_instances), or nil if no name was located.

## Description

This is an implementation of the `qnx_name_locate` C function. The only difference is that the return value contains both the located task ID and the number of copies of the name found. The task ID is the car of the return value, and the number of copies is the cdr of the return value.

## Example

See the Starting qserve and nserve section of the Common Functions chapter (Tutorial One), or the Linux, QNX 4, or QNX 6 section of the Abstracted Functions chapter in the Cogent Tools Demo and Tutorials book for examples of this function used in context.

        Gamma> qnx_name_locate(0,"qnx/pipe",0);
        (35 . 1)

## See Also

`qnx_name_attach`, `qnx_name_detach`

Prev | Home | Next
`qnx_name_detach` | Up | `qnx_osinfo`

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