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.

24.10.2. CONFIGURE_INIT_TASK_ATTRIBUTES

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.

24.10.3. CONFIGURE_INIT_TASK_ENTRY_POINT

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.

24.10.4. CONFIGURE_INIT_TASK_INITIAL_MODES

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.

24.10.5. CONFIGURE_INIT_TASK_NAME

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.

24.10.6. CONFIGURE_INIT_TASK_PRIORITY

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.

24.10.7. CONFIGURE_INIT_TASK_STACK_SIZE

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.

24.10.8. CONFIGURE_RTEMS_INIT_TASKS_TABLE

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.