RTEMS 4.7.2 On-Line Library

Timer Manager TIMER_INITIATE_SERVER - Initiate server for task-based timers

RTEMS C User's Guide

8.4.7: TIMER_INITIATE_SERVER - Initiate server for task-based timers

CALLING SEQUENCE:

rtems_status_code rtems_timer_initiate_server(
  uint32_t         priority,
  uint32_t         stack_size,
  rtems_attribute  attribute_set
)
);

DIRECTIVE STATUS CODES:

RTEMS_SUCCESSFUL - Timer Server initiated successfully
RTEMS_TOO_MANY - too many tasks created

DESCRIPTION:

This directive initiates the Timer Server task. This task is responsible for executing all timers initiated via the rtems_timer_server_fire_after or rtems_timer_server_fire_when directives.

NOTES:

This directive could cause the calling task to be preempted.

The Timer Server task is created using the rtems_task_create service and must be accounted for when configuring the system.

Even through this directive invokes the rtems_task_create and rtems_task_start directives, it should only fail due to resource allocation problems.

RTEMS C User's Guide