User Extension Handler

Functions
void	_User_extensions_Handler_initialization (uint32_t number_of_extensions, User_extensions_Table *initial_extensions)
	User extensions Handler Initialization.
void	_User_extensions_Add_API_set (User_extensions_Control *the_extension)
	User extensions Add to API extension set.
void	_User_extensions_Add_set (User_extensions_Control *the_extension, User_extensions_Table *extension_table)
	User extensions Add extension set.
void	_User_extensions_Remove_set (User_extensions_Control *the_extension)
boolean	_User_extensions_Thread_create (Thread_Control *the_thread)
	User extensions Thread create.
void	_User_extensions_Thread_delete (Thread_Control *the_thread)
	User extensions Thread delete.
void	_User_extensions_Thread_start (Thread_Control *the_thread)
	User extensions Thread start.
void	_User_extensions_Thread_restart (Thread_Control *the_thread)
	User extensions Thread restart.
void	_User_extensions_Thread_begin (Thread_Control *executing)
	User extensions Thread begin.
void	_User_extensions_Thread_switch (Thread_Control *executing, Thread_Control *heir)
	User extensions Thread switch.
void	_User_extensions_Thread_exitted (Thread_Control *executing)
	User extensions Thread exitted.
void	_User_extensions_Fatal (Internal_errors_Source the_source, boolean is_internal, uint32_t the_error)
	User extensions Fatal.

---

Detailed Description

This handler encapsulates functionality related to the management of the user extensions to the SuperCore that are available to the user.

---

Function Documentation

void _User_extensions_Add_API_set

(

User_extensions_Control *

the_extension

)

User extensions Add to API extension set.

This routine is used to add an API extension set to the active list.

Parameters:

[in]

the_extension

is the extension set to add

void _User_extensions_Add_set	(	User_extensions_Control *	the_extension,
		User_extensions_Table *	extension_table
	)

User extensions Add extension set.

This routine is used to add a user extension set to the active list.

Parameters:

[in]	the_extension	is the extension set to add
[in]	extension_table	is the user's extension set

void _User_extensions_Fatal	(	Internal_errors_Source	the_source,
		boolean	is_internal,
		uint32_t	the_error
	)

User extensions Fatal.

This routine is used to invoke the user extension invoked when a fatal error occurs.

Parameters:

[in]	the_source	is the source of the fatal error.
[in]	is_internal	is TRUE if the error originated inside RTEMS.
[in]	the_error	is an indication of the actual error.

void _User_extensions_Handler_initialization	(	uint32_t	number_of_extensions,
		User_extensions_Table *	initial_extensions
	)

User extensions Handler Initialization.

This routine performs the initialization necessary for this handler.

Parameters:

[in]	number_of_extensions	is the number of extensions
[in]	initial_extensions	is the initial extension set

void _User_extensions_Remove_set

(

User_extensions_Control *

the_extension

)

This routine is used to remove a user extension set from the active list.

void _User_extensions_Thread_begin

(

Thread_Control *

executing

)

User extensions Thread begin.

This routine is used to invoke the user extension which is invoked when a thread begins.

Parameters:

[in]

executing

is the thread beginning to execute.

boolean _User_extensions_Thread_create

(

Thread_Control *

the_thread

)

User extensions Thread create.

This routine is used to invoke the user extension for the thread creation operate.

Parameters:

[in]

the_thread

is the thread being created.

Returns:

This method returns TRUE if the user extension executed successfully.

void _User_extensions_Thread_delete

(

Thread_Control *

the_thread

)

User extensions Thread delete.

This routine is used to invoke the user extension for the thread deletion operation.

Parameters:

[in]

the_thread

is the thread being deleted.

void _User_extensions_Thread_exitted

(

Thread_Control *

executing

)

User extensions Thread exitted.

This routine is used to invoke the user extension which is invoked when a thread exits.

Parameters:

[in]

executing

is the thread voluntarily exiting.

void _User_extensions_Thread_restart

(

Thread_Control *

the_thread

)

User extensions Thread restart.

This routine is used to invoke the user extension for the thread restart operation.

Parameters:

[in]

the_thread

is the thread being restarted.

void _User_extensions_Thread_start

(

Thread_Control *

the_thread

)

User extensions Thread start.

This routine is used to invoke the user extension for the thread start operation.

Parameters:

[in]

the_thread

is the thread being started.

void _User_extensions_Thread_switch	(	Thread_Control *	executing,
		Thread_Control *	heir
	)

User extensions Thread switch.

This routine is used to invoke the user extension which is invoked when a context switch occurs.

Parameters:

[in]	executing	is the thread currently executing.
[in]	heir	is the thread which will execute.