diff options
Diffstat (limited to 'c-user/config/task-stack-alloc.rst')
-rw-r--r-- | c-user/config/task-stack-alloc.rst | 73 |
1 files changed, 37 insertions, 36 deletions
diff --git a/c-user/config/task-stack-alloc.rst b/c-user/config/task-stack-alloc.rst index e031595..513815c 100644 --- a/c-user/config/task-stack-alloc.rst +++ b/c-user/config/task-stack-alloc.rst @@ -22,28 +22,29 @@ CONFIGURE_TASK_STACK_ALLOCATOR CONSTANT: ``CONFIGURE_TASK_STACK_ALLOCATOR`` -DATA TYPE: - Function pointer. - -RANGE: - Undefined or valid function pointer. +OPTION TYPE: + This configuration option is an initializer define. DEFAULT VALUE: The default value is ``_Workspace_Allocate``, which indicates that task stacks will be allocated from the RTEMS Workspace. +VALUE CONSTRAINTS: + The value of this configuration option shall be defined to a valid function + pointer of the type ``void *( *allocate )( size_t )``. + DESCRIPTION: - ``CONFIGURE_TASK_STACK_ALLOCATOR`` may point to a user provided routine to - allocate task stacks. + The value of this configuration option initializes the stack allocator + allocate handler. NOTES: - A correctly configured system must configure the following to be consistent: + A correctly configured system shall configure the following to be consistent: - - ``CONFIGURE_TASK_STACK_ALLOCATOR_INIT`` + - :ref:`CONFIGURE_TASK_STACK_ALLOCATOR_INIT` - - ``CONFIGURE_TASK_STACK_ALLOCATOR`` + - `CONFIGURE_TASK_STACK_ALLOCATOR` - - ``CONFIGURE_TASK_STACK_DEALLOCATOR`` + - :ref:`CONFIGURE_TASK_STACK_DEALLOCATOR` .. index:: CONFIGURE_TASK_STACK_ALLOCATOR_INIT @@ -55,29 +56,28 @@ CONFIGURE_TASK_STACK_ALLOCATOR_INIT CONSTANT: ``CONFIGURE_TASK_STACK_ALLOCATOR_INIT`` -DATA TYPE: - Function pointer. - -RANGE: - Undefined, NULL or valid function pointer. +OPTION TYPE: + This configuration option is an initializer define. DEFAULT VALUE: - The default value is NULL, which indicates that task stacks will be - allocated from the RTEMS Workspace. + The default value is ``NULL``. + +VALUE CONSTRAINTS: + The value of this configuration option shall be defined to a valid function + pointer of the type ``void ( *initialize )( size_t )`` or to ``NULL``. DESCRIPTION: - ``CONFIGURE_TASK_STACK_ALLOCATOR_INIT`` configures the initialization - method for an application or BSP specific task stack allocation - implementation. + The value of this configuration option initializes the stack allocator + initialization handler. NOTES: - A correctly configured system must configure the following to be consistent: + A correctly configured system shall configure the following to be consistent: - - ``CONFIGURE_TASK_STACK_ALLOCATOR_INIT`` + - `CONFIGURE_TASK_STACK_ALLOCATOR_INIT` - - ``CONFIGURE_TASK_STACK_ALLOCATOR`` + - :ref:`CONFIGURE_TASK_STACK_ALLOCATOR` - - ``CONFIGURE_TASK_STACK_DEALLOCATOR`` + - :ref:`CONFIGURE_TASK_STACK_DEALLOCATOR` .. index:: CONFIGURE_TASK_STACK_DEALLOCATOR .. index:: task stack deallocator @@ -90,25 +90,26 @@ CONFIGURE_TASK_STACK_DEALLOCATOR CONSTANT: ``CONFIGURE_TASK_STACK_DEALLOCATOR`` -DATA TYPE: - Function pointer. - -RANGE: - Undefined or valid function pointer. +OPTION TYPE: + This configuration option is an initializer define. DEFAULT VALUE: The default value is ``_Workspace_Free``, which indicates that task stacks will be allocated from the RTEMS Workspace. +VALUE CONSTRAINTS: + The value of this configuration option shall be defined to a valid function + pointer of the type ``void ( *deallocate )( void * )``. + DESCRIPTION: - ``CONFIGURE_TASK_STACK_DEALLOCATOR`` may point to a user provided routine - to free task stacks. + The value of this configuration option initializes the stack allocator + deallocate handler. NOTES: - A correctly configured system must configure the following to be consistent: + A correctly configured system shall configure the following to be consistent: - - ``CONFIGURE_TASK_STACK_ALLOCATOR_INIT`` + - :ref:`CONFIGURE_TASK_STACK_ALLOCATOR_INIT` - - ``CONFIGURE_TASK_STACK_ALLOCATOR`` + - :ref:`CONFIGURE_TASK_STACK_ALLOCATOR` - - ``CONFIGURE_TASK_STACK_DEALLOCATOR`` + - `CONFIGURE_TASK_STACK_DEALLOCATOR` |