RTEMS 4.8.1 On-Line Library

User Extensions Manager TASK_CREATE Extension

RTEMS C User's Guide

22.2.3.1: TASK_CREATE Extension

The TASK_CREATE extension directly corresponds to the rtems_task_create directive. If this extension is defined in any static or dynamic extension set and a task is being created, then the extension routine will automatically be invoked by RTEMS. The extension should have a prototype similar to the following:

boolean user_task_create(
  rtems_tcb *current_task,
  rtems_tcb *new_task
);

where current_task can be used to access the TCB for the currently executing task, and new_task can be used to access the TCB for the new task being created. This extension is invoked from the rtems_task_create directive after new_task has been completely initialized, but before it is placed on a ready TCB chain.

The user extension is expected to return the boolean value TRUE if it successfully executed and FALSE otherwise. A task create user extension will frequently attempt to allocate resources. If this allocation fails, then the extension should return FALSE and the entire task create operation will fail.

RTEMS C User's Guide