rtems/rtems-docs
1
0
Fork 0
mirror of https://git.rtems.org/rtems-docs/ synced 2025-05-16 05:46:40 +08:00
Code Issues Packages Projects Releases Wiki Activity

c-user: CONFIGURE_MINIMUM_POSIX_THREAD_STACK_SIZE

Browse Source 
Close #3434.
This commit is contained in:
Sebastian Huber 2018-08-07 08:37:22 +02:00
parent 8fd9e62fac
commit 806806cdcf
1 changed files with 37 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

44
c-user/configuring_a_system.rst
View File

@ -1227,6 +1227,31 @@ NOTES:
All POSIX threads have floating point enabled. 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 POSIX Initialization Threads Table Configuration
================================================ ================================================
@ -1606,17 +1631,17 @@ RANGE:
Positive. Positive.
DEFAULT VALUE: DEFAULT VALUE:
This is not defined by default, which sets the executive to the recommended The default value is architecture-specific.
minimum stack size for this processor.
DESCRIPTION: DESCRIPTION:
The configuration parameter is set to the number of bytes the application This configuration parameter defines the minimum stack size in bytes for
wants the minimum stack size to be for every task or thread in the system. every user 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.
NOTES: 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 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 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 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 recommended. This can be used in higher memory systems to reduce the risk
of stack overflow without performing analysis on actual consumption. 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:: CONFIGURE_INTERRUPT_STACK_SIZE
.. index:: interrupt stack size .. index:: interrupt stack size