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
    		

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