User Extensions Manager

The User Extensions Manager allows the application developer to augment the executive by allowing them to supply extension routines which are invoked at critical system events. More...

Files
file	extension.h
	This header file defines the User Extensions Manager API.

Typedefs
typedef User_extensions_Table	rtems_extensions_table
	%
typedef User_extensions_fatal_extension	rtems_fatal_extension
	%
typedef Internal_errors_t	rtems_fatal_code
	%
typedef Internal_errors_Source	rtems_fatal_source
	%
typedef User_extensions_thread_begin_extension	rtems_task_begin_extension
	%
typedef User_extensions_thread_create_extension	rtems_task_create_extension
	%
typedef User_extensions_thread_delete_extension	rtems_task_delete_extension
	%
typedef User_extensions_thread_exitted_extension	rtems_task_exitted_extension
	%
typedef User_extensions_thread_restart_extension	rtems_task_restart_extension
	%
typedef User_extensions_thread_start_extension	rtems_task_start_extension
	%
typedef User_extensions_thread_switch_extension	rtems_task_switch_extension
	%
typedef User_extensions_thread_terminate_extension	rtems_task_terminate_extension
	%

Functions
rtems_status_code	rtems_extension_create (rtems_name name, const rtems_extensions_table *extension_table, rtems_id *id)
	% More...
rtems_status_code	rtems_extension_delete (rtems_id id)
	% More...
rtems_status_code	rtems_extension_ident (rtems_name name, rtems_id *id)
	Identifies an extension set object by the specified object name. More...

Detailed Description

The User Extensions Manager allows the application developer to augment the executive by allowing them to supply extension routines which are invoked at critical system events.

Function Documentation

rtems_extension_create()

rtems_status_code rtems_extension_create	(	rtems_name	name,
		const rtems_extensions_table *	extension_table,
		rtems_id *	id
	)

%

Parameters

name	%
extension_table	%
id	%

Definition at line 27 of file extensioncreate.c.

rtems_extension_delete()

rtems_status_code rtems_extension_delete

(

rtems_id

id

)

%

Parameters

id

%

Definition at line 25 of file extensiondelete.c.

rtems_extension_ident()

rtems_status_code rtems_extension_ident	(	rtems_name	name,
		rtems_id *	id
	)

Identifies an extension set object by the specified object name.

This directive obtains the extension set identifier associated with the extension set name specified in name.

If the extension set name is not unique, then the extension set identifier will match the first extension set with that name in the search order. However, this extension set identifier is not guaranteed to correspond to the desired extension set. The extension set identifier is used with other extension related directives to access the extension set.

The objects are searched from lowest to the highest index. Only the local node is searched.

Parameters

	name	is the object name to look up.
[out]	id	is the pointer to an object identifier variable. The object identifier of an object with the specified name will be stored in this variable, in case of a successful operation.

Return values

RTEMS_SUCCESSFUL	The requested operation was successful.
RTEMS_INVALID_ADDRESS	The id parameter was NULL.
RTEMS_INVALID_NAME	The name parameter was 0.
RTEMS_INVALID_NAME	There was no object with the specified name on the local node.

Definition at line 44 of file extensionident.c.