c-user: Use new template for feature config opts

Update #3900.
This commit is contained in:
Sebastian Huber 2020-03-30 11:13:44 +02:00
parent 0103b685c6
commit 2f18a530bc

View File

@ -199,18 +199,28 @@ CONFIGURE_DISABLE_BSP_SETTINGS
CONSTANT: CONSTANT:
``CONFIGURE_DISABLE_BSP_SETTINGS`` ``CONFIGURE_DISABLE_BSP_SETTINGS``
DATA TYPE: OPTION TYPE:
Boolean feature macro. This configuration option is a boolean feature define.
RANGE: DEFAULT CONFIGURATION:
Defined or undefined. If this configuration option is undefined, then the described feature is not
enabled.
DEFAULT VALUE:
This is not defined by default.
DESCRIPTION: DESCRIPTION:
All BSP specific configuration settings can be disabled by the application In case this configuration option is defined, then the following BSP related
with the ``CONFIGURE_DISABLE_BSP_SETTINGS`` option. configuration options are undefined:
- :ref:`BSP_IDLE_TASK_BODY`
- :ref:`BSP_IDLE_TASK_STACK_SIZE`
- :ref:`BSP_INITIAL_EXTENSION`
- :ref:`BSP_INTERRUPT_STACK_SIZE`
- :ref:`CONFIGURE_BSP_PREREQUISITE_DRIVERS`
- :ref:`CONFIGURE_MALLOC_BSP_SUPPORTS_SBRK`
NOTES: NOTES:
None. None.
@ -225,23 +235,25 @@ CONFIGURE_MALLOC_BSP_SUPPORTS_SBRK
CONSTANT: CONSTANT:
``CONFIGURE_MALLOC_BSP_SUPPORTS_SBRK`` ``CONFIGURE_MALLOC_BSP_SUPPORTS_SBRK``
DATA TYPE: OPTION TYPE:
Boolean feature macro. This configuration option is a boolean feature define.
RANGE: DEFAULT CONFIGURATION:
Defined or undefined. If this configuration option is undefined, then the described feature is not
enabled.
DEFAULT VALUE:
This option is BSP specific.
DESCRIPTION: DESCRIPTION:
This configuration parameter is defined by a BSP to indicate that it does If
not allocate all available memory to the C Program Heap used by the Malloc
Family of routines.
If defined, when ``malloc()`` is unable to allocate memory, it will call * this configuration option is defined by the BSP
the BSP supplied ``sbrk()`` to obtain more memory.
* and :ref:`CONFIGURE_DISABLE_BSP_SETTINGS` is undefined,
then not all memory is made available to the C Program Heap immediately at
system initialization time. When :c:func:`malloc()` or other standard memory
allocation functions are unable to allocate memory, they will call the BSP
supplied :c:func:`sbrk()` function to obtain more memory.
NOTES: NOTES:
This parameter should not be defined by the application. Only the BSP knows This option should not be defined by the application. Only the BSP knows how
how it allocates memory to the C Program Heap. it allocates memory to the C Program Heap.