RTEMS 4.5.0 On-Line Library

Task Manager TASK_SUSPEND - Suspend a task

RTEMS Ada User's Guide

5.4.6: TASK_SUSPEND - Suspend a task

CALLING SEQUENCE:

procedure Task_Suspend (
   ID     : in     RTEMS.ID;
   Result :    out RTEMS.Status_Codes
);

DIRECTIVE STATUS CODES:

RTEMS.SUCCESSFUL - task restarted successfully
RTEMS.INVALID_ID - task id invalid
RTEMS.ALREADY_SUSPENDED - task already suspended

DESCRIPTION:

This directive suspends the task specified by id from further execution by placing it in the suspended state. This state is additive to any other blocked state that the task may already be in. The task will not execute again until another task issues the rtems.task_resume directive for this task and any blocked state has been removed.

NOTES:

The requesting task can suspend itself by specifying RTEMS.SELF as id. In this case, the task will be suspended and a successful return code will be returned when the task is resumed.

Suspending a global task which does not reside on the local node will generate a request to the remote node to suspend the specified task.

If the task specified by id is already suspended, then the RTEMS.ALREADY_SUSPENDED status code is returned.

RTEMS Ada User's Guide