RTEMS 4.6.0pre5 On-Line Library

Task Manager TASK_START - Start a task

RTEMS Ada User's Guide

5.4.3: TASK_START - Start a task

CALLING SEQUENCE:

procedure Task_Start (
   ID          : in     RTEMS.ID;
   Entry_Point : in     System.Address;
   Argument    : in     RTEMS.Task_Argument_PTR;
   Result      :    out RTEMS.Status_Codes
);

DIRECTIVE STATUS CODES:

RTEMS.SUCCESSFUL - ask started successfully
RTEMS.INVALID_ADDRESS - invalid task entry point
RTEMS.INVALID_ID - invalid task id
RTEMS.INCORRECT_STATE - task not in the dormant state
RTEMS.ILLEGAL_ON_REMOTE_OBJECT - cannot start remote task

DESCRIPTION:

This directive readies the task, specified by tid, for execution based on the priority and execution mode specified when the task was created. The starting address of the task is given in entry_point. The task's starting argument is contained in argument. This argument can be a single value or used as an index into an array of parameter blocks.

NOTES:

The calling task will be preempted if its preemption mode is enabled and the task being started has a higher priority.

Any actions performed on a dormant task such as suspension or change of priority are nullified when the task is initiated via the rtems.task_start directive.

RTEMS Ada User's Guide