summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSebastian Huber <sebastian.huber@embedded-brains.de>2018-08-07 08:37:22 +0200
committerSebastian Huber <sebastian.huber@embedded-brains.de>2018-08-07 08:37:22 +0200
commit806806cdcf7ecd98bdcbd07378106e40376fc0ae (patch)
tree2488378cdbd09e87ff0cd627d41e97f4f169c2c9
parent8fd9e62facbd0b781758a346095b7f6d0c183ce1 (diff)
downloadrtems-docs-806806cdcf7ecd98bdcbd07378106e40376fc0ae.tar.bz2
c-user: CONFIGURE_MINIMUM_POSIX_THREAD_STACK_SIZE
Close #3434.
-rw-r--r--c-user/configuring_a_system.rst44
1 files changed, 37 insertions, 7 deletions
diff --git a/c-user/configuring_a_system.rst b/c-user/configuring_a_system.rst
index a22d321..f35d2bb 100644
--- a/c-user/configuring_a_system.rst
+++ b/c-user/configuring_a_system.rst
@@ -1227,6 +1227,31 @@ NOTES:
All POSIX threads have floating point enabled.
+.. index:: CONFIGURE_MINIMUM_POSIX_THREAD_STACK_SIZE
+.. index:: minimum POSIX thread stack size
+
+.. _CONFIGURE_MINIMUM_POSIX_THREAD_STACK_SIZE:
+
+CONFIGURE_MINIMUM_POSIX_THREAD_STACK_SIZE
+-----------------------------------------
+
+CONSTANT:
+ ``CONFIGURE_MINIMUM_POSIX_THREAD_STACK_SIZE``
+
+DATA TYPE:
+ Unsigned integer (``size_t``).
+
+RANGE:
+ Positive.
+
+DEFAULT VALUE:
+ The default value is two times the value of
+ :ref:`CONFIGURE_MINIMUM_TASK_STACK_SIZE <CONFIGURE_MINIMUM_TASK_STACK_SIZE>`.
+
+DESCRIPTION:
+ This configuration parameter defines the minimum stack size in bytes for
+ every POSIX thread in the system.
+
POSIX Initialization Threads Table Configuration
================================================
@@ -1606,17 +1631,17 @@ RANGE:
Positive.
DEFAULT VALUE:
- This is not defined by default, which sets the executive to the recommended
- minimum stack size for this processor.
+ The default value is architecture-specific.
DESCRIPTION:
- The configuration parameter is set to the number of bytes the application
- wants the minimum stack size to be for every task or thread in the system.
-
- Adjusting this parameter should be done with caution. Examining the actual
- usage using the Stack Checker Usage Reporting facility is recommended.
+ This configuration parameter defines the minimum stack size in bytes for
+ every user task or thread in the system.
NOTES:
+ Adjusting this parameter should be done with caution. Examining the actual
+ stack usage using the stack checker usage reporting facility is recommended
+ (see also :ref:`CONFIGURE_STACK_CHECKER_ENABLED <CONFIGURE_STACK_CHECKER_ENABLED>`).
+
This parameter can be used to lower the minimum from that recommended. This
can be used in low memory systems to reduce memory consumption for
stacks. However, this must be done with caution as it could increase the
@@ -1626,6 +1651,11 @@ NOTES:
recommended. This can be used in higher memory systems to reduce the risk
of stack overflow without performing analysis on actual consumption.
+ By default, this configuration parameter defines also the minimum stack
+ size of POSIX threads. This can be changed with the
+ :ref:`CONFIGURE_MINIMUM_POSIX_THREAD_STACK_SIZE <CONFIGURE_MINIMUM_POSIX_THREAD_STACK_SIZE>`
+ configuration option.
+
.. index:: CONFIGURE_INTERRUPT_STACK_SIZE
.. index:: interrupt stack size