threadDelete(2K)

NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | RETURN VALUES | ERRORS | RESTRICTIONS | ATTRIBUTES | SEE ALSO

NAME

threadDelete- delete a thread

SYNOPSIS

#include <exec/chExec.h>

int threadDelete(KnCap *actorcap, KnThreadLid threadli);

API RESTRICTIONS

The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.

See API(5FEA) for details.

DESCRIPTION

threadDelete() deletes the thread whose local identifier is threadli in the actor whose capability is actorcap.

If actorcap is K_MYACTOR, the deleted thread must belong to the current actor.

In this case, if threadli is K_MYSELF, the current thread is deleted.

In user mode, pdtThreadDelete() should always be called before threadDelete() is invoked. This frees all per-thread data allocated in the system or in the libraries.

RETURN VALUES

On successful completion, a value of 0 is returned. Otherwise, a negative error code is returned.

ERRORS

K_EINVAL

actorcap is an inconsistent actor capability, or threadli is not a valid thread identifier in the specified actor.

K_EUNKNOWN

actorcap does not specify a reachable actor.

K_EFAULT

Some of the provided data are outside the current actor's address space.

K_BUSY

The thread is already in the process of being deleted.

K_EPRIV

A user actor cannot delete a supervisor thread.

RESTRICTIONS

The target actor and the current actor must be located on the same site.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

SEE ALSO

threadCreate(2K), pdtThreadDelete(2K)

ChorusOS 5.0  Last Revised December 2001

NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | RETURN VALUES | ERRORS | RESTRICTIONS | ATTRIBUTES | SEE ALSO