24.10. Classic API Initialization Task Configuration¶

This section describes configuration options related to the Classic API initialization task.

24.10.1. CONFIGURE_INIT_TASK_ARGUMENTS¶

CONSTANT:: CONFIGURE_INIT_TASK_ARGUMENTS
OPTION TYPE:: This configuration option is an integer define.
DEFAULT VALUE:: The default value is 0.
VALUE CONSTRAINTS:: The value of this configuration option shall be a valid integer of type rtems_task_argument.
DESCRIPTION:: The value of this configuration option defines task argument of the Classic API initialization task.
NOTES:: None.

CONSTANT:: CONFIGURE_INIT_TASK_ATTRIBUTES
OPTION TYPE:: This configuration option is an integer define.
DEFAULT VALUE:: The default value is RTEMS_DEFAULT_ATTRIBUTES.
VALUE CONSTRAINTS:: The value of this configuration option shall be a valid task attribute set.
DESCRIPTION:: The value of this configuration option defines the task attributes of the Classic API initialization task.
NOTES:: None.

CONSTANT:: CONFIGURE_INIT_TASK_ENTRY_POINT
OPTION TYPE:: This configuration option is an initializer define.
DEFAULT VALUE:: The default value is Init.
VALUE CONSTRAINTS:: The value of this configuration option shall be defined to a valid function pointer of the type void ( *entry_point )( rtems_task_argument ).
DESCRIPTION:: The value of this configuration option initializes the entry point of the Classic API initialization task.
NOTES:: The application shall provide the function referenced by this configuration option.

CONSTANT:: CONFIGURE_INIT_TASK_INITIAL_MODES
OPTION TYPE:: This configuration option is an integer define.
DEFAULT VALUE:: In SMP configurations, the default value is RTEMS_DEFAULT_MODES, otherwise the default value is RTEMS_NO_PREEMPT.
VALUE CONSTRAINTS:: The value of this configuration option shall be a valid task mode set.
DESCRIPTION:: The value of this configuration option defines the initial execution mode of the Classic API initialization task.
NOTES:: None.

CONSTANT:: CONFIGURE_INIT_TASK_NAME
OPTION TYPE:: This configuration option is an integer define.
DEFAULT VALUE:: The default value is rtems_build_name( 'U', 'I', '1', ' ' ).
VALUE CONSTRAINTS:: The value of this configuration option shall be a valid integer of type rtems_name.
DESCRIPTION:: The value of this configuration option defines the name of the Classic API initialization task.
NOTES:: Use rtems_build_name() to define the task name.

CONSTANT:: CONFIGURE_INIT_TASK_PRIORITY
OPTION TYPE:: This configuration option is an integer define.
DEFAULT VALUE:: The default value is 1.
VALUE CONSTRAINTS:: The value of this configuration option shall be a valid Classic API task priority. The set of valid task priorities is scheduler-specific.
DESCRIPTION:: The value of this configuration option defines the initial priority of the Classic API initialization task.
NOTES:: None.

CONSTANT:

CONFIGURE_INIT_TASK_STACK_SIZE

OPTION TYPE:

This configuration option is an integer define.

DEFAULT VALUE:

The default value is CONFIGURE_MINIMUM_TASK_STACK_SIZE.

VALUE CONSTRAINTS:

The value of this configuration option shall satisfy all of the following constraints:

It shall be greater than or equal to CONFIGURE_MINIMUM_TASK_STACK_SIZE.
It shall be small enough so that the task stack space calculation carried out by <rtems/confdefs.h> does not overflow an integer of type uintptr_t.

DESCRIPTION:

The value of this configuration option defines the task stack size of the Classic API initialization task.

NOTES:

None.

CONSTANT:

CONFIGURE_RTEMS_INIT_TASKS_TABLE

OPTION TYPE:

This configuration option is a boolean feature define.

DEFAULT CONFIGURATION:

If this configuration option is undefined, then the described feature is not enabled.

DESCRIPTION:

In case this configuration option is defined, then exactly one Classic API initialization task is configured.

NOTES:

The application shall define exactly one of the following configuration options

otherwise a compile time error in the configuration file will occur.