[docs] c-user: Remove obsolete config section

Sebastian Huber sebastian.huber at embedded-brains.de
Mon Feb 6 18:52:22 UTC 2023


This commit already clarified that the defines of the removed section
are optional BSP provided default values and not application
configuration options:

commit cf9f2121577b11f8eab5e49c48173c46cf09c627
Author: Sebastian Huber <sebastian.huber at embedded-brains.de>
Date:   Wed Nov 17 08:46:56 2021 +0100

    c-user: Clarify BSP related configuration settings
---
 c-user/config/bsp-related.rst | 355 ----------------------------------
 c-user/config/index.rst       |   1 -
 2 files changed, 356 deletions(-)
 delete mode 100644 c-user/config/bsp-related.rst

diff --git a/c-user/config/bsp-related.rst b/c-user/config/bsp-related.rst
deleted file mode 100644
index b13a91d..0000000
--- a/c-user/config/bsp-related.rst
+++ /dev/null
@@ -1,355 +0,0 @@
-.. SPDX-License-Identifier: CC-BY-SA-4.0
-
-.. Copyright (C) 2020, 2021 embedded brains GmbH (http://www.embedded-brains.de)
-.. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
-
-.. This file is part of the RTEMS quality process and was automatically
-.. generated.  If you find something that needs to be fixed or
-.. worded better please post a report or patch to an RTEMS mailing list
-.. or raise a bug report:
-..
-.. https://www.rtems.org/bugs.html
-..
-.. For information on updating and regenerating please refer to the How-To
-.. section in the Software Requirements Engineering chapter of the
-.. RTEMS Software Engineering manual.  The manual is provided as a part of
-.. a release.  For development sources please refer to the online
-.. documentation at:
-..
-.. https://docs.rtems.org
-
-.. Generated from spec:/acfg/if/group-bsp
-
-BSP Related Configuration Options
-=================================
-
-This section describes configuration options related to the BSP.  Some
-configuration options may have a BSP-specific setting which is defined by
-``<bsp.h>``.  The BSP-specific settings can be disabled by the
-:ref:`CONFIGURE_DISABLE_BSP_SETTINGS` configuration option.
-
-.. Generated from spec:/acfg/if/bsp-idle-task-body
-
-.. raw:: latex
-
-    \clearpage
-
-.. index:: BSP_IDLE_TASK_BODY
-
-.. _BSP_IDLE_TASK_BODY:
-
-BSP_IDLE_TASK_BODY
-------------------
-
-.. rubric:: CONSTANT:
-
-``BSP_IDLE_TASK_BODY``
-
-.. rubric:: OPTION TYPE:
-
-This configuration option is an initializer define.
-
-.. rubric:: DEFAULT VALUE:
-
-The default value is BSP-specific.
-
-.. rubric:: DESCRIPTION:
-
-If
-
-* this configuration option is defined by the BSP
-
-* and :ref:`CONFIGURE_DISABLE_BSP_SETTINGS` is undefined,
-
-then the value of this configuration option defines the default value of
-:ref:`CONFIGURE_IDLE_TASK_BODY`.
-
-.. rubric:: NOTES:
-
-As it has knowledge of the specific CPU model, system controller logic, and
-peripheral buses, a BSP-specific IDLE task may be capable of turning
-components off to save power during extended periods of no task activity.
-
-.. rubric:: CONSTRAINTS:
-
-The value of the configuration option shall be defined to a valid function
-pointer of the type ``void *( *idle_body )( uintptr_t )``.
-
-.. Generated from spec:/acfg/if/bsp-idle-task-stack-size
-
-.. raw:: latex
-
-    \clearpage
-
-.. index:: BSP_IDLE_TASK_STACK_SIZE
-
-.. _BSP_IDLE_TASK_STACK_SIZE:
-
-BSP_IDLE_TASK_STACK_SIZE
-------------------------
-
-.. rubric:: CONSTANT:
-
-``BSP_IDLE_TASK_STACK_SIZE``
-
-.. rubric:: OPTION TYPE:
-
-This configuration option is an integer define.
-
-.. rubric:: DEFAULT VALUE:
-
-The default value is BSP-specific.
-
-.. rubric:: DESCRIPTION:
-
-If
-
-* this configuration option is defined by the BSP
-
-* and :ref:`CONFIGURE_DISABLE_BSP_SETTINGS` is undefined,
-
-then the value of this configuration option defines the default value of
-:ref:`CONFIGURE_IDLE_TASK_STACK_SIZE`.
-
-.. rubric:: CONSTRAINTS:
-
-The following constraints apply to this configuration option:
-
-* The value of the configuration option shall be greater than or equal to a
-  BSP-specific and application-specific minimum value.
-
-* The value of the configuration option shall be small enough so that the IDLE
-  task stack area calculation carried out by ``<rtems/confdefs.h>`` does not
-  overflow an integer of type `size_t
-  <https://en.cppreference.com/w/c/types/size_t>`_.
-
-.. Generated from spec:/acfg/if/bsp-initial-extension
-
-.. raw:: latex
-
-    \clearpage
-
-.. index:: BSP_INITIAL_EXTENSION
-
-.. _BSP_INITIAL_EXTENSION:
-
-BSP_INITIAL_EXTENSION
----------------------
-
-.. rubric:: CONSTANT:
-
-``BSP_INITIAL_EXTENSION``
-
-.. rubric:: OPTION TYPE:
-
-This configuration option is an initializer define.
-
-.. rubric:: DEFAULT VALUE:
-
-The default value is BSP-specific.
-
-.. rubric:: DESCRIPTION:
-
-If
-
-* this configuration option is defined by the BSP
-
-* and :ref:`CONFIGURE_DISABLE_BSP_SETTINGS` is undefined,
-
-then the value of this configuration option is used to initialize the table
-of initial user extensions.
-
-.. rubric:: NOTES:
-
-The value of this configuration option is placed after the entries of all
-other initial user extensions.
-
-.. rubric:: CONSTRAINTS:
-
-The value of the configuration option shall be a list of initializers for
-structures of type :c:type:`rtems_extensions_table`.
-
-.. Generated from spec:/acfg/if/bsp-interrupt-stack-size
-
-.. raw:: latex
-
-    \clearpage
-
-.. index:: BSP_INTERRUPT_STACK_SIZE
-
-.. _BSP_INTERRUPT_STACK_SIZE:
-
-BSP_INTERRUPT_STACK_SIZE
-------------------------
-
-.. rubric:: CONSTANT:
-
-``BSP_INTERRUPT_STACK_SIZE``
-
-.. rubric:: OPTION TYPE:
-
-This configuration option is an integer define.
-
-.. rubric:: DEFAULT VALUE:
-
-The default value is BSP-specific.
-
-.. rubric:: DESCRIPTION:
-
-If
-
-* this configuration option is defined by the BSP
-
-* and :ref:`CONFIGURE_DISABLE_BSP_SETTINGS` is undefined,
-
-then the value of this configuration option defines the default value of
-:ref:`CONFIGURE_INTERRUPT_STACK_SIZE`.
-
-.. rubric:: CONSTRAINTS:
-
-The following constraints apply to this configuration option:
-
-* The value of the configuration option shall be greater than or equal to a
-  BSP-specific and application-specific minimum value.
-
-* The value of the configuration option shall be small enough so that the
-  interrupt stack area calculation carried out by ``<rtems/confdefs.h>`` does
-  not overflow an integer of type `size_t
-  <https://en.cppreference.com/w/c/types/size_t>`_.
-
-* The value of the configuration option shall be aligned according to
-  :c:macro:`CPU_INTERRUPT_STACK_ALIGNMENT`.
-
-.. Generated from spec:/acfg/if/bsp-prerequisite-drivers
-
-.. raw:: latex
-
-    \clearpage
-
-.. index:: CONFIGURE_BSP_PREREQUISITE_DRIVERS
-
-.. _CONFIGURE_BSP_PREREQUISITE_DRIVERS:
-
-CONFIGURE_BSP_PREREQUISITE_DRIVERS
-----------------------------------
-
-.. rubric:: CONSTANT:
-
-``CONFIGURE_BSP_PREREQUISITE_DRIVERS``
-
-.. rubric:: OPTION TYPE:
-
-This configuration option is an initializer define.
-
-.. rubric:: DEFAULT VALUE:
-
-The default value is BSP-specific.
-
-.. rubric:: DESCRIPTION:
-
-If
-
-* this configuration option is defined by the BSP
-
-* and :ref:`CONFIGURE_DISABLE_BSP_SETTINGS` is undefined,
-
-then the value of this configuration option is used to add BSP-provided
-prerequisite drivers to the Device Driver Table.
-
-.. rubric:: NOTES:
-
-The value of this configuration option is placed before the entries of all
-other initial user extensions (including
-:ref:`CONFIGURE_APPLICATION_PREREQUISITE_DRIVERS`).
-
-.. rubric:: CONSTRAINTS:
-
-The value of the configuration option shall be a list of initializers for
-structures of type :c:type:`rtems_extensions_table`.
-
-.. Generated from spec:/acfg/if/disable-bsp-settings
-
-.. raw:: latex
-
-    \clearpage
-
-.. index:: CONFIGURE_DISABLE_BSP_SETTINGS
-
-.. _CONFIGURE_DISABLE_BSP_SETTINGS:
-
-CONFIGURE_DISABLE_BSP_SETTINGS
-------------------------------
-
-.. rubric:: CONSTANT:
-
-``CONFIGURE_DISABLE_BSP_SETTINGS``
-
-.. rubric:: OPTION TYPE:
-
-This configuration option is a boolean feature define.
-
-.. rubric:: DEFAULT CONFIGURATION:
-
-If this configuration option is undefined, then the described feature is not
-enabled.
-
-.. rubric:: DESCRIPTION:
-
-In case this configuration option is defined, then the following BSP related
-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`
-
-.. Generated from spec:/acfg/if/malloc-bsp-supports-sbrk
-
-.. raw:: latex
-
-    \clearpage
-
-.. index:: CONFIGURE_MALLOC_BSP_SUPPORTS_SBRK
-
-.. _CONFIGURE_MALLOC_BSP_SUPPORTS_SBRK:
-
-CONFIGURE_MALLOC_BSP_SUPPORTS_SBRK
-----------------------------------
-
-.. rubric:: CONSTANT:
-
-``CONFIGURE_MALLOC_BSP_SUPPORTS_SBRK``
-
-.. rubric:: OPTION TYPE:
-
-This configuration option is a boolean feature define.
-
-.. rubric:: DEFAULT CONFIGURATION:
-
-If this configuration option is undefined, then the described feature is not
-enabled.
-
-.. rubric:: DESCRIPTION:
-
-If
-
-* this configuration option is defined by the BSP
-
-* 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.
-
-.. rubric:: NOTES:
-
-This option should not be defined by the application. Only the BSP knows how
-it allocates memory to the C Program Heap.
diff --git a/c-user/config/index.rst b/c-user/config/index.rst
index 498387e..b669ea2 100644
--- a/c-user/config/index.rst
+++ b/c-user/config/index.rst
@@ -26,7 +26,6 @@ Configuring a System
     scheduler-general
     scheduler-clustered
     face-technical-standard
-    bsp-related
     mpci
     libpci
     ada
-- 
2.35.3



More information about the devel mailing list