RTEMS 4.8.1 On-Line Library

Task Manager ITERATE_OVER_ALL_THREADS - Iterate Over Tasks

RTEMS C User's Guide

5.4.15: ITERATE_OVER_ALL_THREADS - Iterate Over Tasks

CALLING SEQUENCE:

typedef void (*rtems_per_thread_routine)(
  Thread_Control *the_thread
);

void rtems_iterate_over_all_threads(
  rtems_per_thread_routine routine
);

DIRECTIVE STATUS CODES: NONE

DESCRIPTION:

This directive iterates over all of the existant threads in the system and invokes routine on each of them. The user should be careful in accessing the contents of the_thread.

This routine is intended for use in diagnostic utilities and is not intented for routine use in an operational system.

NOTES:

There is NO protection while this routine is called. Thus it is possible that the_thread could be deleted while this is operating. By not having protection, the user is free to invoke support routines from the C Library which require semaphores for data structures.

RTEMS C User's Guide