[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


NAME
    FindTask -- find a task with the given name or find oneself

SYNOPSIS
    task = FindTask(name)
    D0              A1

    struct Task *FindTask(STRPTR);

FUNCTION
    This function will check all task queues for a task with the given
    name, and return a pointer to its task control block.  If a NULL
    name pointer is given a pointer to the current task will be
    returned.

    Finding oneself with a NULL for the name is very quick.  Finding a
    task by name is very system expensive, and will disable interrupts
    for a long time.  Since a task may remove itself at any time,
    a Forbid()/Permit() pair may be needed to ensure the pointer
    returned by FindTask() is still valid when used.

INPUT
    name - pointer to a name string

RESULT
    task - pointer to the task (or Process)