RTEMS 4.9.1 On-Line Library

Task Manager exd_tsk - Exit and Delete Issuing Task

RTEMS ITRON 3.0 API User's Guide

1.4.5: exd_tsk - Exit and Delete Issuing Task

CALLING SEQUENCE:

void exd_tsk(void);

STATUS CODES:

E_CTX - Context error (issued from task-independent portions or a task in dispatch disabled state)

* System call may detect the following error. The error is not returned to the context issuing the system call even. Error codes therefore cannot be returned directly as a return parameter of the system call. The behavior on error detection is implementation dependent.

DESCRIPTION:

This system call causes the issuing task to exit and then delete itself. In other words the state of the issuing task changes into the NON-EXISTENT (a virtual state not existing on the system).

NOTES:

When a task exits with exd_tsk, that task does not automatically release all the resources (memory blocks, semaphores, etc.) which it had secured prior to the call. It is the user's responsibility to see to it that all resources are released beforehand.

Exd_tsk is a system call which does not return any parameters to the original issuing context. Accordingly, even if an error code is returned on detection of some error, it is normal for tasks making this system call not to perform any error checking, and it is in fact possible that a program could run out of control. For this reason, even if an error is detected upon making this system call, it is supposed that the error is not returned to the task which issued the system call. If information on detected errors is required it should be left in a messagebuffer used as an error log.

RTEMS ITRON 3.0 API User's Guide