<div dir="ltr"><div dir="ltr"><br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Wed, Nov 25, 2020 at 12:14 AM Sebastian Huber <<a href="mailto:sebastian.huber@embedded-brains.de">sebastian.huber@embedded-brains.de</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Document new configuration option<br>
CONFIGURE_INIT_TASK_CONSTRUCT_STORAGE_SIZE.<br>
<br>
Close #4181.<br>
---<br>
 c-user/config/classic-init-task.rst | 67 ++++++++++++++++++++++++++++-<br>
 1 file changed, 66 insertions(+), 1 deletion(-)<br>
<br>
diff --git a/c-user/config/classic-init-task.rst b/c-user/config/classic-init-task.rst<br>
index 4d3bf81..d848546 100644<br>
--- a/c-user/config/classic-init-task.rst<br>
+++ b/c-user/config/classic-init-task.rst<br>
@@ -79,6 +79,65 @@ DESCRIPTION:<br>
 NOTES:<br>
     None.<br>
<br>
+.. Generated from spec:/acfg/if/init-task-construct-storage-size<br>
+<br>
+.. index:: CONFIGURE_INIT_TASK_CONSTRUCT_STORAGE_SIZE<br>
+<br>
+.. _CONFIGURE_INIT_TASK_CONSTRUCT_STORAGE_SIZE:<br>
+<br>
+CONFIGURE_INIT_TASK_CONSTRUCT_STORAGE_SIZE<br>
+------------------------------------------<br>
+<br>
+CONSTANT:<br>
+    ``CONFIGURE_INIT_TASK_CONSTRUCT_STORAGE_SIZE``<br>
+<br>
+OPTION TYPE:<br>
+    This configuration option is an integer define.<br>
+<br>
+DEFAULT VALUE:<br>
+    The default value is 0.<br>
+<br>
+VALUE CONSTRAINTS:<br>
+    The value of this configuration option shall satisfy all of the following<br>
+    constraints:<br>
+<br>
+    * It shall be greater than or equal to :ref:`CONFIGURE_MINIMUM_TASK_STACK_SIZE`.<br>
+<br></blockquote><div>I guess the constraints don't apply to defaults? Or should an exception be noted, like below .. "if specified"</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
+    * It shall be defined using<br>
+      :c:func:`RTEMS_TASK_STORAGE_SIZE`.<br>
+<br>
+DESCRIPTION:<br>
+    The value of this configuration option defines the task storage size of the<br>
+    Classic API initialization task.<br>
+<br>
+NOTES:<br>
+    If this configuration option is specified, then<br>
+<br>
+    * a task storage area of the specified size is statically allocated by<br>
+      ``<rtems/confdefs.h>`` for the Classic API initialization task,<br>
+<br>
+    * the Classic API initialization task is constructed by<br>
+      :c:func:`rtems_task_construct` instead of using<br>
+      :c:func:`rtems_task_create`,<br>
+<br>
+    * the maximum thread-local storage size defined by<br>
+      :ref:`CONFIGURE_MAXIMUM_THREAD_LOCAL_STORAGE_SIZE` is used for the Classic API<br>
+      initialization task,<br>
+<br>
+    * the Classic API initialization task should be accounted for in<br>
+      :ref:`CONFIGURE_MINIMUM_TASKS_WITH_USER_PROVIDED_STORAGE`, and<br>
+<br>
+    * the task storage area used for the Classic API initialization task is not<br>
+      reclaimed by the system, if the task is deleted.<br></blockquote><div>nit: remove comma</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
+<br>
+    The<br>
+<br>
+    * :ref:`CONFIGURE_INIT_TASK_STACK_SIZE` and<br>
+<br>
+    * ``CONFIGURE_INIT_TASK_CONSTRUCT_STORAGE_SIZE``<br>
+<br>
+    configuration options are mutually exclusive.<br>
+<br>
 .. Generated from spec:/acfg/if/init-task-entrypoint<br>
<br>
 .. index:: CONFIGURE_INIT_TASK_ENTRY_POINT<br>
@@ -229,7 +288,13 @@ DESCRIPTION:<br>
     Classic API initialization task.<br>
<br>
 NOTES:<br>
-    None.<br>
+    The<br>
+<br>
+    * ``CONFIGURE_INIT_TASK_STACK_SIZE`` and<br>
+<br>
+    * :ref:`CONFIGURE_INIT_TASK_CONSTRUCT_STORAGE_SIZE`<br>
+<br>
+    configuration options are mutually exclusive.<br>
<br>
 .. Generated from spec:/acfg/if/rtems-init-tasks-table<br>
<br>
-- <br>
2.26.2<br>
<br>
_______________________________________________<br>
devel mailing list<br>
<a href="mailto:devel@rtems.org" target="_blank">devel@rtems.org</a><br>
<a href="http://lists.rtems.org/mailman/listinfo/devel" rel="noreferrer" target="_blank">http://lists.rtems.org/mailman/listinfo/devel</a><br>
</blockquote></div></div>