RTEMS 4.5.1-pre3 On-Line Library

Task Manager TASK_RESUME - Resume a task

RTEMS Ada User's Guide

5.4.7: TASK_RESUME - Resume a task

CALLING SEQUENCE:

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

DIRECTIVE STATUS CODES:

RTEMS.SUCCESSFUL - task restarted successfully
RTEMS.INVALID_ID - task id invalid
RTEMS.INCORRECT_STATE - task not suspended

DESCRIPTION:

This directive removes the task specified by id from the suspended state. If the task is in the ready state after the suspension is removed, then it will be scheduled to run. If the task is still in a blocked state after the suspension is removed, then it will remain in that blocked state.

NOTES:

The running task may be preempted if its preemption mode is enabled and the local task being resumed has a higher priority.

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

If the task specified by id is not suspended, then the RTEMS.INCORRECT_STATE status code is returned.

RTEMS Ada User's Guide