User Extension Handler Structures

Data Structures
struct	User_extensions_Table
struct	User_extensions_Switch_control
struct	User_extensions_Control
Typedefs
typedef void	User_extensions_routine
typedef boolean(*	User_extensions_thread_create_extension )(Thread_Control *, Thread_Control *)
typedef User_extensions_routine(*	User_extensions_thread_delete_extension )(Thread_Control *, Thread_Control *)
typedef User_extensions_routine(*	User_extensions_thread_start_extension )(Thread_Control *, Thread_Control *)
typedef User_extensions_routine(*	User_extensions_thread_restart_extension )(Thread_Control *, Thread_Control *)
typedef User_extensions_routine(*	User_extensions_thread_switch_extension )(Thread_Control *, Thread_Control *)
typedef User_extensions_routine(*	User_extensions_thread_post_switch_extension )(Thread_Control *)
typedef User_extensions_routine(*	User_extensions_thread_begin_extension )(Thread_Control *)
typedef User_extensions_routine(*	User_extensions_thread_exitted_extension )(Thread_Control *)
typedef User_extensions_routine(*	User_extensions_fatal_extension )(Internal_errors_Source, boolean, uint32_t)
Variables
SCORE_EXTERN Chain_Control	_User_extensions_List
SCORE_EXTERN Chain_Control	_User_extensions_Switches_list

---

Detailed Description

The following records defines the User Extension Table. This table defines the application dependent routines which are invoked at critical points in the life of each thread and the system as a whole.

---

Typedef Documentation

typedef User_extensions_routine( * User_extensions_fatal_extension)(Internal_errors_Source, boolean, uint32_t)

This type defines the prototype of the fatal error extension handler. The handler is passed an indicator of the source of the fatal error, whether it is internal to RTEMS and an error code.

typedef void User_extensions_routine

This type indicates the return type of a user extension method.

typedef User_extensions_routine( * User_extensions_thread_begin_extension)(Thread_Control *)

This type defines the prototype of a thread beginning to execute extension handler. The handler is passed the thread executing. This extension is executed in the context of the beginning thread.

typedef boolean( * User_extensions_thread_create_extension)(Thread_Control *, Thread_Control *)

This type defines the prototype of a thread creation extension handler. The handler is passed the thread executing and the thread being created.

typedef User_extensions_routine( * User_extensions_thread_delete_extension)(Thread_Control *, Thread_Control *)

This type defines the prototype of a thread deletion extension handler. The handler is passed the thread executing and the thread being deleted.

typedef User_extensions_routine( * User_extensions_thread_exitted_extension)(Thread_Control *)

This type defines the prototype of a thread exiting extension handler. The handler is passed the thread exiting.

typedef User_extensions_routine(* User_extensions_thread_post_switch_extension)(Thread_Control *)

This type defines the prototype of a post context switch extension handler. The handler is passed the thread thread being switched to.

typedef User_extensions_routine( * User_extensions_thread_restart_extension)(Thread_Control *, Thread_Control *)

This type defines the prototype of a thread restarting extension handler. The handler is passed the thread executing and the thread being restarted.

typedef User_extensions_routine( * User_extensions_thread_start_extension)(Thread_Control *, Thread_Control *)

This type defines the prototype of thread starting extension handler. The handler is passed the thread executing and the thread being started.

typedef User_extensions_routine( * User_extensions_thread_switch_extension)(Thread_Control *, Thread_Control *)

This type defines the prototype of thread context switch extension handler. The handler is passed the thread currently executing and the thread being switched to.

---

Variable Documentation

SCORE_EXTERN Chain_Control _User_extensions_List

This is used to manage the list of active extensions.

SCORE_EXTERN Chain_Control _User_extensions_Switches_list

This is used to manage a chain of user extension task switch nodes.