[PATCH v2] c-user: Add CONFIGURE_INIT_TASK_STORAGE_SIZE

Sebastian Huber sebastian.huber at embedded-brains.de
Tue Nov 24 07:37:11 UTC 2020


Close #4181.
---
 c-user/config/classic-init-task.rst | 59 ++++++++++++++++++++++++++++-
 1 file changed, 58 insertions(+), 1 deletion(-)

diff --git a/c-user/config/classic-init-task.rst b/c-user/config/classic-init-task.rst
index 4d3bf81..7b28acb 100644
--- a/c-user/config/classic-init-task.rst
+++ b/c-user/config/classic-init-task.rst
@@ -229,7 +229,64 @@ DESCRIPTION:
     Classic API initialization task.
 
 NOTES:
-    None.
+    The
+
+    * ``CONFIGURE_INIT_TASK_STACK_SIZE`` and
+
+    * :ref:`CONFIGURE_INIT_TASK_STORAGE_SIZE`
+
+    configuration options are mutually exclusive.
+
+.. Generated from spec:/acfg/if/init-task-storage-size
+
+.. index:: CONFIGURE_INIT_TASK_STORAGE_SIZE
+
+.. _CONFIGURE_INIT_TASK_STORAGE_SIZE:
+
+CONFIGURE_INIT_TASK_STORAGE_SIZE
+--------------------------------
+
+CONSTANT:
+    ``CONFIGURE_INIT_TASK_STORAGE_SIZE``
+
+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 satisfy all of the following
+    constraints:
+
+    * It shall be greater than or equal to :ref:`CONFIGURE_MINIMUM_TASK_STACK_SIZE`.
+
+    * It shall be defined using
+      :c:func:`RTEMS_TASK_STORAGE_SIZE`.
+
+DESCRIPTION:
+    The value of this configuration option defines the task storage size of the
+    Classic API initialization task.
+
+NOTES:
+    A task storage area of the specified size is statically allocated for the
+    Classic API initialization task.  It is defined by ``<rtems/confdefs.h>`.
+
+    If this configuration option is specified, then a maximum thread-local
+    storage size defined by :ref:`CONFIGURE_MAXIMUM_THREAD_LOCAL_STORAGE_SIZE` is used for
+    the Classic API initialization task.
+
+    If this configuration option is specified, then the Classic API
+    initialization task should be accounted for in
+    :ref:`CONFIGURE_MINIMUM_TASKS_WITH_USER_PROVIDED_STORAGE`.
+
+    The
+
+    * :ref:`CONFIGURE_INIT_TASK_STACK_SIZE` and
+
+    * ``CONFIGURE_INIT_TASK_STORAGE_SIZE``
+
+    configuration options are mutually exclusive.
 
 .. Generated from spec:/acfg/if/rtems-init-tasks-table
 
-- 
2.26.2



More information about the devel mailing list