name_attach

Gamma: Version 4.0
Prev |  | Next

# `name_attach`

`name_attach` -- attaches a name to a task.

## Syntax

    name_attach (task_name)

## Arguments

`task_name`

  The name to attach to this task.

## Returns

t if the name was successfully attached, otherwise nil.

## Description

This function sends a message to the QNX 4 name locator task (`nameloc`) to attach a name on this node. If the name locator is not running or the name has already been attached by another task, the call will fail.

## Example

        // attach my name
        Gamma> name_attach("firstname");
        t
        // attach an alternate name
        Gamma> name_attach("pseudonym");
        t
        // attempt to attach my name again
        Gamma> name_attach("firstname");
        nil

Prev | Home | Next
`locate_task_id` | Up | `nserve_query`

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