[PATCH] c-user: Use configuration option as section name
Sebastian Huber
sebastian.huber at embedded-brains.de
Mon Nov 6 11:56:04 UTC 2017
This makes it easier to find the documentation for a given configuration
option.
Remove superfluous comments.
---
c-user/configuring_a_system.rst | 1120 ++++++++++++++-------------------------
1 file changed, 396 insertions(+), 724 deletions(-)
diff --git a/c-user/configuring_a_system.rst b/c-user/configuring_a_system.rst
index c0b7151..0d4ebd7 100644
--- a/c-user/configuring_a_system.rst
+++ b/c-user/configuring_a_system.rst
@@ -54,8 +54,6 @@ systems can be easily configured using the ``<rtems/confdefs.h>`` mechanism and
that using this mechanism will avoid internal RTEMS configuration changes
impacting applications.
-.. COMMENT: === Philosophy ===
-
Default Value Selection Philosophy
==================================
@@ -65,8 +63,6 @@ possible. By default, no application resources are configured. The
thread is configured and that at least one of the initialization task/thread
tables is configured.
-.. COMMENT: === Sizing the RTEMS Workspace ===
-
.. _Sizing the RTEMS Workspace:
Sizing the RTEMS Workspace
@@ -134,8 +130,6 @@ when:
Failure to provide enough space in the RTEMS Workspace may result in fatal
run-time errors terminating the system.
-.. COMMENT: === Potential Issues ===
-
Potential Issues with RTEMS Workspace Size Estimation
=====================================================
@@ -165,8 +159,6 @@ In general, ``<rtems/confdefs.h>`` is very accurate when given enough
information. However, it is quite easy to use a library and forget to account
for its resources.
-.. COMMENT: === Format to be followed for making changes in this file ===
-
Format to be followed for making changes in this file
=====================================================
@@ -211,8 +203,6 @@ DESCRIPTION:
NOTES:
Any further notes. (No specific format)
-.. COMMENT: === Configuration Example ===
-
Configuration Example
=====================
@@ -295,8 +285,6 @@ things, the application implicitly used the following defaults:
- The minimum task stack size will be that recommended by RTEMS for the target
architecture.
-.. COMMENT: === Unlimited Objects ===
-
.. _Unlimited Objects:
Unlimited Objects
@@ -396,8 +384,6 @@ generally considered a safer embedded systems programming practice to know the
system limits rather than experience an out of memory error at an arbitrary and
largely unpredictable time in the field.
-.. COMMENT: === Per Object Class Unlimited Object Instances ===
-
.. _Per Object Class Unlimited Object Instances:
Per Object Class Unlimited Object Instances
@@ -427,8 +413,6 @@ Object maximum specifications can be evaluated with the
``rtems_resource_is_unlimited`` and``rtems_resource_maximum_per_allocation``
macros.
-.. COMMENT: === Unlimited Object Instances ===
-
.. _Unlimited Object Instances:
Unlimited Object Instances
@@ -439,12 +423,10 @@ provides the capability to make all object classes listed above operate in
unlimited mode in a simple manner. The application developer is only
responsible for enabling unlimited objects and specifying the allocation size.
-.. COMMENT: === CONFIGURE_UNLIMITED_OBJECTS ===
-
-.. _Enable Unlimited Object Instances:
+.. _CONFIGURE_UNLIMITED_OBJECTS:
-Enable Unlimited Object Instances
----------------------------------
+CONFIGURE_UNLIMITED_OBJECTS
+---------------------------
.. index:: CONFIGURE_UNLIMITED_OBJECTS
CONSTANT:
@@ -469,12 +451,10 @@ NOTES:
``CONFIGURE_UNIFIED_WORK_AREAS`` so the system operates with a single pool
of memory for both RTEMS and application memory allocations.
-.. COMMENT: === CONFIGURE_UNLIMITED_ALLOCATION_SIZE ===
-
-.. _Specify Unlimited Objects Allocation Size:
+.. _CONFIGURE_UNLIMITED_ALLOCATION_SIZE:
-Specify Unlimited Objects Allocation Size
------------------------------------------
+CONFIGURE_UNLIMITED_ALLOCATION_SIZE
+-----------------------------------
CONSTANT:
``CONFIGURE_UNLIMITED_ALLOCATION_SIZE``
@@ -506,20 +486,16 @@ NOTES:
#define CONFIGURE_UNLIMITED_OBJECTS
#define CONFIGURE_UNLIMITED_ALLOCATION_SIZE 5
-.. COMMENT: === Classic API Configuration ===
-
Classic API Configuration
=========================
This section defines the Classic API related system configuration parameters
supported by ``<rtems/confdefs.h>``.
-.. COMMENT: === CONFIGURE_MAXIMUM_TASKS ===
-
-.. _Specify Maximum Classic API Tasks:
+.. _CONFIGURE_MAXIMUM_TASKS:
-Specify Maximum Classic API Tasks
----------------------------------
+CONFIGURE_MAXIMUM_TASKS
+-----------------------
.. index:: CONFIGURE_MAXIMUM_TASKS
CONSTANT:
@@ -559,12 +535,10 @@ NOTES:
.. COMMENT: XXX - Add xref to CONFIGURE_MAXIMUM_POSIX_THREADS.
-.. COMMENT: === CONFIGURE_MAXIMUM_TIMERS ===
-
-.. _Specify Maximum Classic API Timers:
+.. _CONFIGURE_MAXIMUM_TIMERS:
-Specify Maximum Classic API Timers
-----------------------------------
+CONFIGURE_MAXIMUM_TIMERS
+------------------------
.. index:: CONFIGURE_MAXIMUM_TIMERS
CONSTANT:
@@ -586,12 +560,10 @@ DESCRIPTION:
NOTES:
This object class can be configured in unlimited allocation mode.
-.. COMMENT: === CONFIGURE_MAXIMUM_SEMAPHORES ===
-
-.. _Specify Maximum Classic API Semaphores:
+.. _CONFIGURE_MAXIMUM_SEMAPHORES:
-Specify Maximum Classic API Semaphores
---------------------------------------
+CONFIGURE_MAXIMUM_SEMAPHORES
+----------------------------
.. index:: CONFIGURE_MAXIMUM_SEMAPHORES
CONSTANT:
@@ -613,12 +585,10 @@ DESCRIPTION:
NOTES:
This object class can be configured in unlimited allocation mode.
-.. COMMENT: === CONFIGURE_MAXIMUM_MRSP_SEMAPHORES ===
-
-.. _Specify Maximum Classic API Semaphores usable with MrsP:
+.. _CONFIGURE_MAXIMUM_MRSP_SEMAPHORES:
-Specify Maximum Classic API Semaphores usable with MrsP
--------------------------------------------------------
+CONFIGURE_MAXIMUM_MRSP_SEMAPHORES
+---------------------------------
.. index:: CONFIGURE_MAXIMUM_MRSP_SEMAPHORES
CONSTANT:
@@ -642,12 +612,10 @@ NOTES:
uni-processor configurations, the :ref:`PriorityCeiling` is used for MrsP
semaphores and thus no extra memory is necessary.
-.. COMMENT: === CONFIGURE_MAXIMUM_MESSAGE_QUEUES ===
-
-.. _Specify Maximum Classic API Message Queues:
+.. _CONFIGURE_MAXIMUM_MESSAGE_QUEUES:
-Specify Maximum Classic API Message Queues
-------------------------------------------
+CONFIGURE_MAXIMUM_MESSAGE_QUEUES
+--------------------------------
.. index:: CONFIGURE_MAXIMUM_MESSAGE_QUEUES
CONSTANT:
@@ -669,12 +637,10 @@ DESCRIPTION:
NOTES:
This object class can be configured in unlimited allocation mode.
-.. COMMENT: === CONFIGURE_MAXIMUM_BARRIERS ===
+.. _CONFIGURE_MAXIMUM_BARRIERS:
-.. _Specify Maximum Classic API Barriers:
-
-Specify Maximum Classic API Barriers
-------------------------------------
+CONFIGURE_MAXIMUM_BARRIERS
+--------------------------
.. index:: CONFIGURE_MAXIMUM_BARRIERS
CONSTANT:
@@ -696,12 +662,10 @@ DESCRIPTION:
NOTES:
This object class can be configured in unlimited allocation mode.
-.. COMMENT: === CONFIGURE_MAXIMUM_PERIODS ===
+.. _CONFIGURE_MAXIMUM_PERIODS:
-.. _Specify Maximum Classic API Periods:
-
-Specify Maximum Classic API Periods
------------------------------------
+CONFIGURE_MAXIMUM_PERIODS
+-------------------------
.. index:: CONFIGURE_MAXIMUM_PERIODS
CONSTANT:
@@ -723,12 +687,10 @@ DESCRIPTION:
NOTES:
This object class can be configured in unlimited allocation mode.
-.. COMMENT: === CONFIGURE_MAXIMUM_PARTITIONS ===
+.. _CONFIGURE_MAXIMUM_PARTITIONS:
-.. _Specify Maximum Classic API Partitions:
-
-Specify Maximum Classic API Partitions
---------------------------------------
+CONFIGURE_MAXIMUM_PARTITIONS
+----------------------------
.. index:: CONFIGURE_MAXIMUM_PARTITIONS
CONSTANT:
@@ -750,12 +712,10 @@ DESCRIPTION:
NOTES:
This object class can be configured in unlimited allocation mode.
-.. COMMENT: === CONFIGURE_MAXIMUM_REGIONS ===
+.. _CONFIGURE_MAXIMUM_REGIONS:
-.. _Specify Maximum Classic API Regions:
-
-Specify Maximum Classic API Regions
------------------------------------
+CONFIGURE_MAXIMUM_REGIONS
+-------------------------
.. index:: CONFIGURE_MAXIMUM_REGIONS
CONSTANT:
@@ -777,12 +737,10 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === CONFIGURE_MAXIMUM_PORTS ===
+.. _CONFIGURE_MAXIMUM_PORTS:
-.. _Specify Maximum Classic API Ports:
-
-Specify Maximum Classic API Ports
----------------------------------
+CONFIGURE_MAXIMUM_PORTS
+-----------------------
.. index:: CONFIGURE_MAXIMUM_PORTS
CONSTANT:
@@ -804,12 +762,10 @@ DESCRIPTION:
NOTES:
This object class can be configured in unlimited allocation mode.
-.. COMMENT: === CONFIGURE_MAXIMUM_USER_EXTENSIONS ===
+.. _CONFIGURE_MAXIMUM_USER_EXTENSIONS:
-.. _Specify Maximum Classic API User Extensions:
-
-Specify Maximum Classic API User Extensions
--------------------------------------------
+CONFIGURE_MAXIMUM_USER_EXTENSIONS
+---------------------------------
.. index:: CONFIGURE_MAXIMUM_USER_EXTENSIONS
CONSTANT:
@@ -831,8 +787,6 @@ DESCRIPTION:
NOTES:
This object class can be configured in unlimited allocation mode.
-.. COMMENT: === Classic API Initialization Task Configuration ===
-
Classic API Initialization Tasks Table Configuration
====================================================
@@ -840,12 +794,10 @@ The ``<rtems/confdefs.h>`` configuration system can automatically generate an
Initialization Tasks Table named ``Initialization_tasks`` with a single entry.
The following parameters control the generation of that table.
-.. COMMENT: === CONFIGURE_RTEMS_INIT_TASKS_TABLE ===
-
-.. _Instantiate Classic API Initialization Task Table:
+.. _CONFIGURE_RTEMS_INIT_TASKS_TABLE:
-Instantiate Classic API Initialization Task Table
--------------------------------------------------
+CONFIGURE_RTEMS_INIT_TASKS_TABLE
+--------------------------------
.. index:: CONFIGURE_RTEMS_INIT_TASKS_TABLE
CONSTANT:
@@ -877,12 +829,10 @@ NOTES:
A compile time error will be generated if the user does not configure any
initialization tasks or threads.
-.. COMMENT: === CONFIGURE_INIT_TASK_ENTRY_POINT ===
+.. _CONFIGURE_INIT_TASK_ENTRY_POINT:
-.. _Specifying Classic API Initialization Task Entry Point:
-
-Specifying Classic API Initialization Task Entry Point
-------------------------------------------------------
+CONFIGURE_INIT_TASK_ENTRY_POINT
+-------------------------------
.. index:: CONFIGURE_INIT_TASK_ENTRY_POINT
CONSTANT:
@@ -906,12 +856,10 @@ NOTES:
The user must implement the function ``Init`` or the function name provided
in this configuration parameter.
-.. COMMENT: === CONFIGURE_INIT_TASK_NAME ===
+.. _CONFIGURE_INIT_TASK_NAME:
-.. _Specifying Classic API Initialization Task Name:
-
-Specifying Classic API Initialization Task Name
------------------------------------------------
+CONFIGURE_INIT_TASK_NAME
+------------------------
.. index:: CONFIGURE_INIT_TASK_NAME
CONSTANT:
@@ -933,12 +881,10 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === CONFIGURE_INIT_TASK_STACK_SIZE ===
-
-.. _Specifying Classic API Initialization Task Stack Size:
+.. _CONFIGURE_INIT_TASK_STACK_SIZE:
-Specifying Classic API Initialization Task Stack Size
------------------------------------------------------
+CONFIGURE_INIT_TASK_STACK_SIZE
+------------------------------
.. index:: CONFIGURE_INIT_TASK_STACK_SIZE
CONSTANT:
@@ -963,12 +909,10 @@ NOTES:
Task/Thread Stack Memory Above Minimum` for more information about
``CONFIGURE_EXTRA_TASK_STACKS``.
-.. COMMENT: === CONFIGURE_INIT_TASK_PRIORITY ===
+.. _CONFIGURE_INIT_TASK_PRIORITY:
-.. _Specifying Classic API Initialization Task Priority:
-
-Specifying Classic API Initialization Task Priority
----------------------------------------------------
+CONFIGURE_INIT_TASK_PRIORITY
+----------------------------
.. index:: CONFIGURE_INIT_TASK_PRIORITY
CONSTANT:
@@ -990,12 +934,10 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === CONFIGURE_INIT_TASK_ATTRIBUTES ===
-
-.. _Specifying Classic API Initialization Task Attributes:
+.. _CONFIGURE_INIT_TASK_ATTRIBUTES:
-Specifying Classic API Initialization Task Attributes
------------------------------------------------------
+CONFIGURE_INIT_TASK_ATTRIBUTES
+------------------------------
.. index:: CONFIGURE_INIT_TASK_ATTRIBUTES
CONSTANT:
@@ -1017,12 +959,10 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === CONFIGURE_INIT_TASK_INITIAL_MODES ===
-
-.. _Specifying Classic API Initialization Task Modes:
+.. _CONFIGURE_INIT_TASK_INITIAL_MODES:
-Specifying Classic API Initialization Task Modes
-------------------------------------------------
+CONFIGURE_INIT_TASK_INITIAL_MODES
+---------------------------------
.. index:: CONFIGURE_INIT_TASK_INITIAL_MODES
CONSTANT:
@@ -1045,12 +985,10 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === CONFIGURE_INIT_TASK_ARGUMENTS ===
-
-.. _Specifying Classic API Initialization Task Arguments:
+.. _CONFIGURE_INIT_TASK_ARGUMENTS:
-Specifying Classic API Initialization Task Arguments
-----------------------------------------------------
+CONFIGURE_INIT_TASK_ARGUMENTS
+-----------------------------
.. index:: CONFIGURE_INIT_TASK_ARGUMENTS
CONSTANT:
@@ -1072,12 +1010,10 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === CONFIGURE_HAS_OWN_INIT_TASK_TABLE ===
+.. _CONFIGURE_HAS_OWN_INIT_TASK_TABLE:
-.. _Not Using Generated Initialization Tasks Table:
-
-Not Using Generated Initialization Tasks Table
-----------------------------------------------
+CONFIGURE_HAS_OWN_INIT_TASK_TABLE
+---------------------------------
.. index:: CONFIGURE_HAS_OWN_INIT_TASK_TABLE
CONSTANT:
@@ -1101,8 +1037,6 @@ NOTES:
This is a seldom used configuration parameter. The most likely use case is
when an application desires to have more than one initialization task.
-.. COMMENT: === POSIX API Configuration ===
-
POSIX API Configuration
=======================
@@ -1110,12 +1044,10 @@ The parameters in this section are used to configure resources for the RTEMS
POSIX API. They are only relevant if the POSIX API is enabled at configure
time using the ``--enable-posix`` option.
-.. COMMENT: === CONFIGURE_MAXIMUM_POSIX_THREADS ===
+.. _CONFIGURE_MAXIMUM_POSIX_THREADS:
-.. _Specify Maximum POSIX API Threads:
-
-Specify Maximum POSIX API Threads
----------------------------------
+CONFIGURE_MAXIMUM_POSIX_THREADS
+-------------------------------
.. index:: CONFIGURE_MAXIMUM_POSIX_THREADS
CONSTANT:
@@ -1150,12 +1082,10 @@ NOTES:
All POSIX threads have floating point enabled.
-.. COMMENT: === CONFIGURE_MAXIMUM_POSIX_KEYS ===
+.. _CONFIGURE_MAXIMUM_POSIX_KEYS:
-.. _Specify Maximum POSIX API Keys:
-
-Specify Maximum POSIX API Keys
-------------------------------
+CONFIGURE_MAXIMUM_POSIX_KEYS
+----------------------------
.. index:: CONFIGURE_MAXIMUM_POSIX_KEYS
CONSTANT:
@@ -1177,14 +1107,10 @@ DESCRIPTION:
NOTES:
This object class can be configured in unlimited allocation mode.
-.. COMMENT: XXX - Key pairs
+.. _CONFIGURE_MAXIMUM_POSIX_TIMERS:
-.. COMMENT: === CONFIGURE_MAXIMUM_POSIX_TIMERS ===
-
-.. _Specify Maximum POSIX API Timers:
-
-Specify Maximum POSIX API Timers
---------------------------------
+CONFIGURE_MAXIMUM_POSIX_TIMERS
+------------------------------
.. index:: CONFIGURE_MAXIMUM_POSIX_TIMERS
CONSTANT:
@@ -1206,12 +1132,10 @@ DESCRIPTION:
NOTES:
This object class can be configured in unlimited allocation mode.
-.. COMMENT: === CONFIGURE_MAXIMUM_POSIX_QUEUED_SIGNALS ===
-
-.. _Specify Maximum POSIX API Queued Signals:
+.. _CONFIGURE_MAXIMUM_POSIX_QUEUED_SIGNALS:
-Specify Maximum POSIX API Queued Signals
-----------------------------------------
+CONFIGURE_MAXIMUM_POSIX_QUEUED_SIGNALS
+--------------------------------------
.. index:: CONFIGURE_MAXIMUM_POSIX_QUEUED_SIGNALS
CONSTANT:
@@ -1233,12 +1157,10 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === CONFIGURE_MAXIMUM_POSIX_MESSAGE_QUEUES ===
-
-.. _Specify Maximum POSIX API Message Queues:
+.. _CONFIGURE_MAXIMUM_POSIX_MESSAGE_QUEUES:
-Specify Maximum POSIX API Message Queues
-----------------------------------------
+CONFIGURE_MAXIMUM_POSIX_MESSAGE_QUEUES
+--------------------------------------
.. index:: CONFIGURE_MAXIMUM_POSIX_MESSAGE_QUEUES
CONSTANT:
@@ -1260,12 +1182,10 @@ DESCRIPTION:
NOTES:
This object class can be configured in unlimited allocation mode.
-.. COMMENT: === CONFIGURE_MAXIMUM_POSIX_SEMAPHORES ===
-
-.. _Specify Maximum POSIX API Semaphores:
+.. _CONFIGURE_MAXIMUM_POSIX_SEMAPHORES:
-Specify Maximum POSIX API Named Semaphores
-------------------------------------------
+CONFIGURE_MAXIMUM_POSIX_SEMAPHORES
+----------------------------------
.. index:: CONFIGURE_MAXIMUM_POSIX_SEMAPHORES
CONSTANT:
@@ -1290,8 +1210,6 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === POSIX Initialization Threads Table Configuration ===
-
POSIX Initialization Threads Table Configuration
================================================
@@ -1299,12 +1217,10 @@ The ``<rtems/confdefs.h>`` configuration system can automatically generate a
POSIX Initialization Threads Table named ``POSIX_Initialization_threads`` with
a single entry. The following parameters control the generation of that table.
-.. COMMENT: === CONFIGURE_POSIX_INIT_THREAD_TABLE ===
-
-.. _Instantiate POSIX API Initialization Thread Table:
+.. _CONFIGURE_POSIX_INIT_THREAD_TABLE:
-Instantiate POSIX API Initialization Thread Table
--------------------------------------------------
+CONFIGURE_POSIX_INIT_THREAD_TABLE
+---------------------------------
.. index:: CONFIGURE_POSIX_INIT_THREAD_TABLE
CONSTANT:
@@ -1338,12 +1254,10 @@ NOTES:
A compile time error will be generated if the user does not configure any
initialization tasks or threads.
-.. COMMENT: === CONFIGURE_POSIX_INIT_THREAD_ENTRY_POINT ===
-
-.. _Specifying POSIX API Initialization Thread Entry Point:
+.. _CONFIGURE_POSIX_INIT_THREAD_ENTRY_POINT:
-Specifying POSIX API Initialization Thread Entry Point
-------------------------------------------------------
+CONFIGURE_POSIX_INIT_THREAD_ENTRY_POINT
+---------------------------------------
.. index:: CONFIGURE_POSIX_INIT_THREAD_ENTRY_POINT
CONSTANT:
@@ -1367,12 +1281,10 @@ NOTES:
The user must implement the function ``POSIX_Init`` or the function name
provided in this configuration parameter.
-.. COMMENT: === CONFIGURE_POSIX_INIT_THREAD_STACK_SIZE ===
+.. _CONFIGURE_POSIX_INIT_THREAD_STACK_SIZE:
-.. _Specifying POSIX API Initialization Thread Stack Size:
-
-Specifying POSIX API Initialization Thread Stack Size
------------------------------------------------------
+CONFIGURE_POSIX_INIT_THREAD_STACK_SIZE
+--------------------------------------
.. index:: CONFIGURE_POSIX_INIT_THREAD_STACK_SIZE
CONSTANT:
@@ -1398,12 +1310,10 @@ NOTES:
Task/Thread Stack Memory Above Minimum` for more information about
``CONFIGURE_EXTRA_TASK_STACKS``.
-.. COMMENT: === CONFIGURE_POSIX_HAS_OWN_INIT_THREAD_TABLE ===
-
-.. _Not Using Generated POSIX Initialization Threads Table:
+.. _CONFIGURE_POSIX_HAS_OWN_INIT_THREAD_TABLE:
-Not Using Generated POSIX Initialization Threads Table
-------------------------------------------------------
+CONFIGURE_POSIX_HAS_OWN_INIT_THREAD_TABLE
+-----------------------------------------
.. index:: CONFIGURE_POSIX_HAS_OWN_INIT_THREAD_TABLE
CONSTANT:
@@ -1427,20 +1337,16 @@ NOTES:
This is a seldom used configuration parameter. The most likely use case is
when an application desires to have more than one initialization task.
-.. COMMENT: === Basic System Information ===
-
Basic System Information
========================
This section defines the general system configuration parameters supported by
``<rtems/confdefs.h>``.
-.. COMMENT: === CONFIGURE_UNIFIED_WORK_AREAS ===
-
-.. _Separate or Unified Work Areas:
+.. _CONFIGURE_UNIFIED_WORK_AREAS:
-Separate or Unified Work Areas
-------------------------------
+CONFIGURE_UNIFIED_WORK_AREAS
+----------------------------
.. index:: CONFIGURE_UNIFIED_WORK_AREAS
.. index:: unified work areas
.. index:: separate work areas
@@ -1478,12 +1384,10 @@ NOTES:
you run out of all available memory rather then just until you run out of
RTEMS Workspace.
-.. COMMENT: === CONFIGURE_MAXIMUM_PROCESSORS ===
-
.. _CONFIGURE_MAXIMUM_PROCESSORS:
-Specify Maximum Processors
-----------------------------------------
+CONFIGURE_MAXIMUM_PROCESSORS
+----------------------------
.. index:: CONFIGURE_MAXIMUM_PROCESSORS
CONSTANT:
@@ -1511,12 +1415,10 @@ NOTES:
ignored. This configuration define is ignored in uni-processor
configurations.
-.. COMMENT: === CONFIGURE_MICROSECONDS_PER_TICK ===
-
.. _CONFIGURE_MICROSECONDS_PER_TICK:
-Length of Each Clock Tick
--------------------------
+CONFIGURE_MICROSECONDS_PER_TICK
+-------------------------------
.. index:: CONFIGURE_MICROSECONDS_PER_TICK
.. index:: tick quantum
@@ -1558,12 +1460,10 @@ NOTES:
There may be BSP specific limits on the resolution or maximum value of a
clock tick quantum.
-.. COMMENT: === CONFIGURE_TICKS_PER_TIMESLICE ===
-
-.. _Specifying Timeslicing Quantum:
+.. _CONFIGURE_TICKS_PER_TIMESLICE:
-Specifying Timeslicing Quantum
-------------------------------
+CONFIGURE_TICKS_PER_TIMESLICE
+-----------------------------
.. index:: CONFIGURE_TICKS_PER_TIMESLICE
.. index:: ticks per timeslice
@@ -1587,12 +1487,10 @@ NOTES:
This configuration parameter has no impact if the Clock Tick Device driver
is not configured.
-.. COMMENT: === CONFIGURE_MAXIMUM_PRIORITY ===
-
-.. _Specifying the Number of Thread Priority Levels:
+.. _CONFIGURE_MAXIMUM_PRIORITY:
-Specifying the Number of Thread Priority Levels
------------------------------------------------
+CONFIGURE_MAXIMUM_PRIORITY
+--------------------------
.. index:: CONFIGURE_MAXIMUM_PRIORITY
.. index:: maximum priority
.. index:: number of priority levels
@@ -1634,12 +1532,10 @@ NOTES:
priority level. Reducing the number of priorities from 256 levels to
sixteen (16) can reduce memory usage by about three (3) kilobytes.
-.. COMMENT: === CONFIGURE_MAXIMUM_THREAD_NAME_SIZE ===
-
.. _CONFIGURE_MAXIMUM_THREAD_NAME_SIZE:
-Specifying the Maximum Thread Name Size
----------------------------------------
+CONFIGURE_MAXIMUM_THREAD_NAME_SIZE
+----------------------------------
.. index:: CONFIGURE_MAXIMUM_THREAD_NAME_SIZE
.. index:: maximum thread name size
@@ -1665,12 +1561,10 @@ NOTE:
The size of the thread control block is increased by the maximum thread name
size. This configuration option is available since RTEMS 4.12.
-.. COMMENT: === CONFIGURE_MINIMUM_TASK_STACK_SIZE ===
-
-.. _Specifying the Minimum Task Size:
+.. _CONFIGURE_MINIMUM_TASK_STACK_SIZE:
-Specifying the Minimum Task Size
---------------------------------
+CONFIGURE_MINIMUM_TASK_STACK_SIZE
+---------------------------------
.. index:: CONFIGURE_MINIMUM_TASK_STACK_SIZE
.. index:: minimum task stack size
@@ -1704,12 +1598,10 @@ NOTES:
recommended. This can be used in higher memory systems to reduce the risk
of stack overflow without performing analysis on actual consumption.
-.. COMMENT: === CONFIGURE_INTERRUPT_STACK_SIZE ===
-
-.. _Configuring the Size of the Interrupt Stack:
+.. _CONFIGURE_INTERRUPT_STACK_SIZE:
-Configuring the Size of the Interrupt Stack
--------------------------------------------
+CONFIGURE_INTERRUPT_STACK_SIZE
+------------------------------
.. index:: CONFIGURE_INTERRUPT_STACK_SIZE
.. index:: interrupt stack size
@@ -1739,12 +1631,10 @@ NOTES:
calculations when the interrupt stack is intended to be allocated from the
RTEMS Workspace would be welcomed by the RTEMS Project.
-.. COMMENT: === CONFIGURE_EXTRA_TASK_STACKS ===
-
-.. _Reserve Task/Thread Stack Memory Above Minimum:
+.. _CONFIGURE_EXTRA_TASK_STACKS:
-Reserve Task/Thread Stack Memory Above Minimum
-----------------------------------------------
+CONFIGURE_EXTRA_TASK_STACKS
+---------------------------
.. index:: CONFIGURE_EXTRA_TASK_STACKS
.. index:: memory for task tasks
@@ -1770,12 +1660,10 @@ NOTES:
stacks larger then the minimum, then that memory is NOT accounted for by
``<rtems/confdefs.h>``.
-.. COMMENT: === CONFIGURE_ZERO_WORKSPACE_AUTOMATICALLY ===
+.. _CONFIGURE_ZERO_WORKSPACE_AUTOMATICALLY:
-.. _Automatically Zeroing the RTEMS Workspace and C Program Heap:
-
-Automatically Zeroing the RTEMS Workspace and C Program Heap
-------------------------------------------------------------
+CONFIGURE_ZERO_WORKSPACE_AUTOMATICALLY
+--------------------------------------
.. index:: CONFIGURE_ZERO_WORKSPACE_AUTOMATICALLY
.. index:: clear C Program Heap
.. index:: clear RTEMS Workspace
@@ -1804,12 +1692,10 @@ NOTES:
Zeroing memory can add significantly to system boot time. It is not
necessary for RTEMS but is often assumed by support libraries.
-.. COMMENT: === CONFIGURE_STACK_CHECKER_ENABLED ===
-
-.. _Enable The Task Stack Usage Checker:
+.. _CONFIGURE_STACK_CHECKER_ENABLED:
-Enable The Task Stack Usage Checker
------------------------------------
+CONFIGURE_STACK_CHECKER_ENABLED
+-------------------------------
.. index:: CONFIGURE_STACK_CHECKER_ENABLED
CONSTANT:
@@ -1834,12 +1720,10 @@ NOTES:
This increases the time required to create tasks as well as adding overhead
to each context switch.
-.. COMMENT: === CONFIGURE_INITIAL_EXTENSIONS ===
-
.. _CONFIGURE_INITIAL_EXTENSIONS:
-Specify Application Specific User Extensions
---------------------------------------------
+CONFIGURE_INITIAL_EXTENSIONS
+----------------------------
.. index:: CONFIGURE_INITIAL_EXTENSIONS
CONSTANT:
@@ -1862,8 +1746,6 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === Custom Stack Allocator ===
-
Configuring Custom Task Stack Allocation
========================================
@@ -1872,12 +1754,10 @@ deallocation methods for task stacks. This can be used to place task stacks in
special areas of memory or to utilize a Memory Management Unit so that stack
overflows are detected in hardware.
-.. COMMENT: === CONFIGURE_TASK_STACK_ALLOCATOR_INIT ===
-
-.. _Custom Task Stack Allocator Initialization:
+.. _CONFIGURE_TASK_STACK_ALLOCATOR_INIT:
-Custom Task Stack Allocator Initialization
-------------------------------------------
+CONFIGURE_TASK_STACK_ALLOCATOR_INIT
+-----------------------------------
.. index:: CONFIGURE_TASK_STACK_ALLOCATOR_INIT
CONSTANT:
@@ -1907,12 +1787,10 @@ NOTES:
- ``CONFIGURE_TASK_STACK_DEALLOCATOR``
-.. COMMENT: === CONFIGURE_TASK_STACK_ALLOCATOR ===
-
-.. _Custom Task Stack Allocator:
+.. _CONFIGURE_TASK_STACK_ALLOCATOR:
-Custom Task Stack Allocator
----------------------------
+CONFIGURE_TASK_STACK_ALLOCATOR
+------------------------------
.. index:: CONFIGURE_TASK_STACK_ALLOCATOR
.. index:: task stack allocator
@@ -1943,12 +1821,10 @@ NOTES:
- ``CONFIGURE_TASK_STACK_DEALLOCATOR``
-.. COMMENT: === CONFIGURE_TASK_STACK_DEALLOCATOR ===
-
-.. _Custom Task Stack Deallocator:
+.. _CONFIGURE_TASK_STACK_DEALLOCATOR:
-Custom Task Stack Deallocator
------------------------------
+CONFIGURE_TASK_STACK_DEALLOCATOR
+--------------------------------
.. index:: CONFIGURE_TASK_STACK_DEALLOCATOR
.. index:: task stack deallocator
@@ -1978,20 +1854,16 @@ NOTES:
- ``CONFIGURE_TASK_STACK_DEALLOCATOR``
-.. COMMENT: === Classic API Message Buffers ===
-
Configuring Memory for Classic API Message Buffers
==================================================
This section describes the configuration parameters related to specifying the
amount of memory reserved for Classic API Message Buffers.
-.. COMMENT: === CONFIGURE_MESSAGE_BUFFERS_FOR_QUEUE ===
+.. _CONFIGURE_MESSAGE_BUFFERS_FOR_QUEUE:
-.. _Calculate Memory for a Single Classic Message API Message Queue:
-
-Calculate Memory for a Single Classic Message API Message Queue
----------------------------------------------------------------
+CONFIGURE_MESSAGE_BUFFERS_FOR_QUEUE
+-----------------------------------
.. index:: CONFIGURE_MESSAGE_BUFFERS_FOR_QUEUE
.. index:: memory for a single message queue's buffers
@@ -2026,12 +1898,10 @@ NOTES:
This macro is only used in support of ``CONFIGURE_MESSAGE_BUFFER_MEMORY``.
-.. COMMENT: === CONFIGURE_MESSAGE_BUFFER_MEMORY ===
-
-.. _Reserve Memory for All Classic Message API Message Queues:
+.. _CONFIGURE_MESSAGE_BUFFER_MEMORY:
-Reserve Memory for All Classic Message API Message Queues
----------------------------------------------------------
+CONFIGURE_MESSAGE_BUFFER_MEMORY
+-------------------------------
.. index:: CONFIGURE_MESSAGE_BUFFER_MEMORY
.. index:: configure message queue buffer memory
@@ -2071,8 +1941,6 @@ NOTES:
500, sizeof(other_message_type) \
)
-.. COMMENT: === Seldom Used Configuration Parameters ===
-
Seldom Used Configuration Parameters
====================================
@@ -2081,12 +1949,10 @@ This section describes configuration parameters supported by
tend to be oriented to debugging system configurations and providing
work-arounds when the memory estimated by ``<rtems/confdefs.h>`` is incorrect.
-.. COMMENT: === CONFIGURE_MEMORY_OVERHEAD ===
-
-.. _Specify Memory Overhead:
+.. _CONFIGURE_MEMORY_OVERHEAD:
-Specify Memory Overhead
------------------------
+CONFIGURE_MEMORY_OVERHEAD
+-------------------------
.. index:: CONFIGURE_MEMORY_OVERHEAD
CONSTANT:
@@ -2111,12 +1977,10 @@ NOTES:
Typically the memory allocation will be too low when an application does
not account for all message queue buffers or task stacks.
-.. COMMENT: === CONFIGURE_HAS_OWN_CONFIGURATION_TABLE ===
+.. _CONFIGURE_HAS_OWN_CONFIGURATION_TABLE:
-.. _Do Not Generate Configuration Information:
-
-Do Not Generate Configuration Information
------------------------------------------
+CONFIGURE_HAS_OWN_CONFIGURATION_TABLE
+-------------------------------------
.. index:: CONFIGURE_HAS_OWN_CONFIGURATION_TABLE
CONSTANT:
@@ -2138,20 +2002,16 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === C Library Support Configuration ===
-
C Library Support Configuration
===============================
This section defines the file system and IO library related configuration
parameters supported by ``<rtems/confdefs.h>``.
-.. COMMENT: === CONFIGURE_LIBIO_MAXIMUM_FILE_DESCRIPTORS ===
-
-.. _Specify Maximum Number of File Descriptors:
+.. _CONFIGURE_LIBIO_MAXIMUM_FILE_DESCRIPTORS:
-Specify Maximum Number of File Descriptors
-------------------------------------------
+CONFIGURE_LIBIO_MAXIMUM_FILE_DESCRIPTORS
+----------------------------------------
.. index:: CONFIGURE_LIBIO_MAXIMUM_FILE_DESCRIPTORS
.. index:: maximum file descriptors
@@ -2177,12 +2037,10 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === CONFIGURE_TERMIOS_DISABLED ===
-
-.. _Disable POSIX Termios Support:
+.. _CONFIGURE_TERMIOS_DISABLED:
-Disable POSIX Termios Support
------------------------------
+CONFIGURE_TERMIOS_DISABLED
+--------------------------
.. index:: CONFIGURE_TERMIOS_DISABLED
CONSTANT:
@@ -2207,12 +2065,10 @@ NOTES:
executable unless it is directly referenced by the application or a device
driver.
-.. COMMENT: === CONFIGURE_NUMBER_OF_TERMIOS_PORTS ===
-
-.. _Specify Maximum Termios Ports:
+.. _CONFIGURE_NUMBER_OF_TERMIOS_PORTS:
-Specify Maximum Termios Ports
------------------------------
+CONFIGURE_NUMBER_OF_TERMIOS_PORTS
+---------------------------------
.. index:: CONFIGURE_NUMBER_OF_TERMIOS_PORTS
CONSTANT:
@@ -2238,19 +2094,15 @@ NOTES:
(e.g. ``CONFIGURE_APPLICATION_NEEDS_CONSOLE_DRIVER``), then it is highly
likely that this configuration parameter should NOT be is defined.
-.. COMMENT: === File System Configuration Parameters ===
-
File System Configuration Parameters
====================================
This section defines File System related configuration parameters.
-.. COMMENT: === CONFIGURE_HAS_OWN_MOUNT_TABLE ===
+.. _CONFIGURE_HAS_OWN_MOUNT_TABLE:
-.. _Providing Application Specific Mount Table:
-
-Providing Application Specific Mount Table
-------------------------------------------
+CONFIGURE_HAS_OWN_MOUNT_TABLE
+-----------------------------
.. index:: CONFIGURE_HAS_OWN_MOUNT_TABLE
CONSTANT:
@@ -2279,12 +2131,10 @@ NOTES:
.. COMMENT: XXX - Please provide an example
-.. COMMENT: === CONFIGURE_USE_DEVFS_AS_BASE_FILESYSTEM ===
+.. _CONFIGURE_USE_DEVFS_AS_BASE_FILESYSTEM:
-.. _Configure devFS as Root File System:
-
-Configure devFS as Root File System
------------------------------------
+CONFIGURE_USE_DEVFS_AS_BASE_FILESYSTEM
+--------------------------------------
.. index:: CONFIGURE_USE_DEVFS_AS_BASE_FILESYSTEM
CONSTANT:
@@ -2311,12 +2161,10 @@ NOTES:
The devFS is comparable in functionality to the pseudo-filesystem name
space provided before RTEMS release 4.5.0.
-.. COMMENT: === CONFIGURE_MAXIMUM_DEVICES ===
+.. _CONFIGURE_MAXIMUM_DEVICES:
-.. _Specifying Maximum Devices for devFS:
-
-Specifying Maximum Devices for devFS
-------------------------------------
+CONFIGURE_MAXIMUM_DEVICES
+-------------------------
.. index:: CONFIGURE_MAXIMUM_DEVICES
CONSTANT:
@@ -2342,12 +2190,10 @@ NOTES:
only impacts the devFS and thus is only used by ``<rtems/confdefs.h>`` when
``CONFIGURE_USE_DEVFS_AS_BASE_FILESYSTEM`` is specified.
-.. COMMENT: === CONFIGURE_APPLICATION_DISABLE_FILESYSTEM ===
+.. _CONFIGURE_APPLICATION_DISABLE_FILESYSTEM:
-.. _Disable File System Support:
-
-Disable File System Support
----------------------------
+CONFIGURE_APPLICATION_DISABLE_FILESYSTEM
+----------------------------------------
.. index:: CONFIGURE_APPLICATION_DISABLE_FILESYSTEM
CONSTANT:
@@ -2371,12 +2217,10 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === CONFIGURE_USE_MINIIMFS_AS_BASE_FILESYSTEM ===
+.. _CONFIGURE_USE_MINIIMFS_AS_BASE_FILESYSTEM:
-.. _Use a Root IMFS with a Minimalistic Feature Set:
-
-Use a Root IMFS with a Minimalistic Feature Set
------------------------------------------------
+CONFIGURE_USE_MINIIMFS_AS_BASE_FILESYSTEM
+-----------------------------------------
.. index:: CONFIGURE_USE_MINIIMFS_AS_BASE_FILESYSTEM
CONSTANT:
@@ -2411,12 +2255,10 @@ DESCRIPTION:
- ``CONFIGURE_IMFS_DISABLE_UNMOUNT``.
-.. COMMENT: === CONFIGURE_IMFS_MEMFILE_BYTES_PER_BLOCK ===
+.. _CONFIGURE_IMFS_MEMFILE_BYTES_PER_BLOCK:
-.. _Specify Block Size for IMFS:
-
-Specify Block Size for IMFS
----------------------------
+CONFIGURE_IMFS_MEMFILE_BYTES_PER_BLOCK
+--------------------------------------
.. index:: CONFIGURE_IMFS_MEMFILE_BYTES_PER_BLOCK
CONSTANT:
@@ -2461,12 +2303,10 @@ DESCRIPTION:
- when the block size is 512 bytes, the maximum file size is 1,082,195,456
bytes.
-.. COMMENT: === CONFIGURE_IMFS_DISABLE_CHOWN ===
+.. _CONFIGURE_IMFS_DISABLE_CHOWN:
-.. _Disable Change Owner Support of Root IMFS:
-
-Disable Change Owner Support of Root IMFS
------------------------------------------
+CONFIGURE_IMFS_DISABLE_CHOWN
+----------------------------
.. index:: CONFIGURE_IMFS_DISABLE_CHOWN
CONSTANT:
@@ -2485,12 +2325,10 @@ DESCRIPTION:
In case this configuration option is defined, then the support to change
the owner is disabled in the root IMFS.
-.. COMMENT: === CONFIGURE_IMFS_DISABLE_CHMOD ===
+.. _CONFIGURE_IMFS_DISABLE_CHMOD:
-.. _Disable Change Mode Support of Root IMFS:
-
-Disable Change Mode Support of Root IMFS
-----------------------------------------
+CONFIGURE_IMFS_DISABLE_CHMOD
+----------------------------
.. index:: CONFIGURE_IMFS_DISABLE_CHMOD
CONSTANT:
@@ -2509,12 +2347,10 @@ DESCRIPTION:
In case this configuration option is defined, then the support to change
the mode is disabled in the root IMFS.
-.. COMMENT: === CONFIGURE_IMFS_DISABLE_UTIME ===
+.. _CONFIGURE_IMFS_DISABLE_UTIME:
-.. _Disable Change Times Support of Root IMFS:
-
-Disable Change Times Support of Root IMFS
------------------------------------------
+CONFIGURE_IMFS_DISABLE_UTIME
+----------------------------
.. index:: CONFIGURE_IMFS_DISABLE_UTIME
CONSTANT:
@@ -2533,12 +2369,10 @@ DESCRIPTION:
In case this configuration option is defined, then the support to change
times is disabled in the root IMFS.
-.. COMMENT: === CONFIGURE_IMFS_DISABLE_LINK ===
+.. _CONFIGURE_IMFS_DISABLE_LINK:
-.. _Disable Create Hard Link Support of Root IMFS:
-
-Disable Create Hard Link Support of Root IMFS
----------------------------------------------
+CONFIGURE_IMFS_DISABLE_LINK
+---------------------------
.. index:: CONFIGURE_IMFS_DISABLE_LINK
CONSTANT:
@@ -2557,12 +2391,10 @@ DESCRIPTION:
In case this configuration option is defined, then the support to create
hard links is disabled in the root IMFS.
-.. COMMENT: === CONFIGURE_IMFS_DISABLE_SYMLINK ===
-
-.. _Disable Create Symbolic Link Support of Root IMFS:
+.. _CONFIGURE_IMFS_DISABLE_SYMLINK:
-Disable Create Symbolic Link Support of Root IMFS
--------------------------------------------------
+CONFIGURE_IMFS_DISABLE_SYMLINK
+------------------------------
.. index:: CONFIGURE_IMFS_DISABLE_SYMLINK
CONSTANT:
@@ -2581,12 +2413,10 @@ DESCRIPTION:
In case this configuration option is defined, then the support to create
symbolic links is disabled in the root IMFS.
-.. COMMENT: === CONFIGURE_IMFS_DISABLE_READLINK ===
-
-.. _Disable Read Symbolic Link Support of Root IMFS:
+.. _CONFIGURE_IMFS_DISABLE_READLINK:
-Disable Read Symbolic Link Support of Root IMFS
------------------------------------------------
+CONFIGURE_IMFS_DISABLE_READLINK
+-------------------------------
.. index:: CONFIGURE_IMFS_DISABLE_READLINK
CONSTANT:
@@ -2605,12 +2435,10 @@ DESCRIPTION:
In case this configuration option is defined, then the support to read
symbolic links is disabled in the root IMFS.
-.. COMMENT: === CONFIGURE_IMFS_DISABLE_RENAME ===
-
-.. _Disable Rename Support of Root IMFS:
+.. _CONFIGURE_IMFS_DISABLE_RENAME:
-Disable Rename Support of Root IMFS
------------------------------------
+CONFIGURE_IMFS_DISABLE_RENAME
+-----------------------------
.. index:: CONFIGURE_IMFS_DISABLE_RENAME
CONSTANT:
@@ -2629,12 +2457,10 @@ DESCRIPTION:
In case this configuration option is defined, then the support to rename
nodes is disabled in the root IMFS.
-.. COMMENT: === CONFIGURE_IMFS_DISABLE_READDIR ===
+.. _CONFIGURE_IMFS_DISABLE_READDIR:
-.. _Disable Directory Read Support of Root IMFS:
-
-Disable Directory Read Support of Root IMFS
--------------------------------------------
+CONFIGURE_IMFS_DISABLE_READDIR
+------------------------------
.. index:: CONFIGURE_IMFS_DISABLE_READDIR
CONSTANT:
@@ -2654,12 +2480,10 @@ DESCRIPTION:
directory is disabled in the root IMFS. It is still possible to open nodes
in a directory.
-.. COMMENT: === CONFIGURE_IMFS_DISABLE_MOUNT ===
+.. _CONFIGURE_IMFS_DISABLE_MOUNT:
-.. _Disable Mount Support of Root IMFS:
-
-Disable Mount Support of Root IMFS
-----------------------------------
+CONFIGURE_IMFS_DISABLE_MOUNT
+----------------------------
.. index:: CONFIGURE_IMFS_DISABLE_MOUNT
CONSTANT:
@@ -2678,12 +2502,10 @@ DESCRIPTION:
In case this configuration option is defined, then the support to mount
other file systems is disabled in the root IMFS.
-.. COMMENT: === CONFIGURE_IMFS_DISABLE_UNMOUNT ===
+.. _CONFIGURE_IMFS_DISABLE_UNMOUNT:
-.. _Disable Unmount Support of Root IMFS:
-
-Disable Unmount Support of Root IMFS
-------------------------------------
+CONFIGURE_IMFS_DISABLE_UNMOUNT
+------------------------------
.. index:: CONFIGURE_IMFS_DISABLE_UNMOUNT
CONSTANT:
@@ -2702,12 +2524,10 @@ DESCRIPTION:
In case this configuration option is defined, then the support to unmount
file systems is disabled in the root IMFS.
-.. COMMENT: === CONFIGURE_IMFS_DISABLE_MKNOD ===
+.. _CONFIGURE_IMFS_DISABLE_MKNOD:
-.. _Disable Make Nodes Support of Root IMFS:
-
-Disable Make Nodes Support of Root IMFS
----------------------------------------
+CONFIGURE_IMFS_DISABLE_MKNOD
+----------------------------
.. index:: CONFIGURE_IMFS_DISABLE_MKNOD
CONSTANT:
@@ -2726,12 +2546,10 @@ DESCRIPTION:
In case this configuration option is defined, then the support to make
directories, devices, regular files and FIFOs is disabled in the root IMFS.
-.. COMMENT: === CONFIGURE_IMFS_DISABLE_MKNOD_FILE ===
+.. _CONFIGURE_IMFS_DISABLE_MKNOD_FILE:
-.. _Disable Make Files Support of Root IMFS:
-
-Disable Make Files Support of Root IMFS
----------------------------------------
+CONFIGURE_IMFS_DISABLE_MKNOD_FILE
+---------------------------------
.. index:: CONFIGURE_IMFS_DISABLE_MKNOD_FILE
CONSTANT:
@@ -2750,12 +2568,10 @@ DESCRIPTION:
In case this configuration option is defined, then the support to make
regular files is disabled in the root IMFS.
-.. COMMENT: === CONFIGURE_IMFS_DISABLE_RMNOD ===
+.. _CONFIGURE_IMFS_DISABLE_RMNOD:
-.. _Disable Remove Nodes Support of Root IMFS:
-
-Disable Remove Nodes Support of Root IMFS
------------------------------------------
+CONFIGURE_IMFS_DISABLE_RMNOD
+----------------------------
.. index:: CONFIGURE_IMFS_DISABLE_RMNOD
CONSTANT:
@@ -2774,20 +2590,16 @@ DESCRIPTION:
In case this configuration option is defined, then the support to remove
nodes is disabled in the root IMFS.
-.. COMMENT: === Block Device Cache Configuration ===
-
Block Device Cache Configuration
================================
This section defines Block Device Cache (bdbuf) related configuration
parameters.
-.. COMMENT: === CONFIGURE_APPLICATION_NEEDS_LIBBLOCK ===
-
-.. _Enable Block Device Cache:
+.. _CONFIGURE_APPLICATION_NEEDS_LIBBLOCK:
-Enable Block Device Cache
--------------------------
+CONFIGURE_APPLICATION_NEEDS_LIBBLOCK
+------------------------------------
.. index:: CONFIGURE_APPLICATION_NEEDS_LIBBLOCK
CONSTANT:
@@ -2810,12 +2622,10 @@ NOTES:
by the user with the configuration options below. The Block Device Cache
is used for example by the RFS and DOSFS file systems.
-.. COMMENT: === CONFIGURE_BDBUF_CACHE_MEMORY_SIZE ===
-
-.. _Size of the Cache Memory:
+.. _CONFIGURE_BDBUF_CACHE_MEMORY_SIZE:
-Size of the Cache Memory
-------------------------
+CONFIGURE_BDBUF_CACHE_MEMORY_SIZE
+---------------------------------
.. index:: CONFIGURE_BDBUF_CACHE_MEMORY_SIZE
CONSTANT:
@@ -2836,12 +2646,10 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === CONFIGURE_BDBUF_BUFFER_MIN_SIZE ===
+.. _CONFIGURE_BDBUF_BUFFER_MIN_SIZE:
-.. _Minimum Size of a Buffer:
-
-Minimum Size of a Buffer
-------------------------
+CONFIGURE_BDBUF_BUFFER_MIN_SIZE
+-------------------------------
.. index:: CONFIGURE_BDBUF_BUFFER_MIN_SIZE
CONSTANT:
@@ -2862,12 +2670,10 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === CONFIGURE_BDBUF_BUFFER_MAX_SIZE ===
+.. _CONFIGURE_BDBUF_BUFFER_MAX_SIZE:
-.. _Maximum Size of a Buffer:
-
-Maximum Size of a Buffer
-------------------------
+CONFIGURE_BDBUF_BUFFER_MAX_SIZE
+-------------------------------
.. index:: CONFIGURE_BDBUF_BUFFER_MAX_SIZE
CONSTANT:
@@ -2888,12 +2694,10 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === CONFIGURE_SWAPOUT_SWAP_PERIOD ===
+.. _CONFIGURE_SWAPOUT_SWAP_PERIOD:
-.. _Swapout Task Swap Period:
-
-Swapout Task Swap Period
-------------------------
+CONFIGURE_SWAPOUT_SWAP_PERIOD
+-----------------------------
.. index:: CONFIGURE_SWAPOUT_SWAP_PERIOD
CONSTANT:
@@ -2914,12 +2718,10 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === CONFIGURE_SWAPOUT_BLOCK_HOLD ===
+.. _CONFIGURE_SWAPOUT_BLOCK_HOLD:
-.. _Swapout Task Maximum Block Hold Time:
-
-Swapout Task Maximum Block Hold Time
-------------------------------------
+CONFIGURE_SWAPOUT_BLOCK_HOLD
+----------------------------
.. index:: CONFIGURE_SWAPOUT_BLOCK_HOLD
CONSTANT:
@@ -2940,12 +2742,10 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === CONFIGURE_SWAPOUT_TASK_PRIORITY ===
+.. _CONFIGURE_SWAPOUT_TASK_PRIORITY:
-.. _Swapout Task Priority:
-
-Swapout Task Priority
----------------------
+CONFIGURE_SWAPOUT_TASK_PRIORITY
+-------------------------------
.. index:: CONFIGURE_SWAPOUT_TASK_PRIORITY
CONSTANT:
@@ -2966,11 +2766,9 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === CONFIGURE_BDBUF_MAX_READ_AHEAD_BLOCKS ===
+.. _CONFIGURE_BDBUF_MAX_READ_AHEAD_BLOCKS:
-.. _Maximum Blocks per Read-Ahead Request:
-
-Maximum Blocks per Read-Ahead Request
+CONFIGURE_BDBUF_MAX_READ_AHEAD_BLOCKS
-------------------------------------
.. index:: CONFIGURE_BDBUF_MAX_READ_AHEAD_BLOCKS
@@ -2994,11 +2792,9 @@ NOTES:
will issue speculative read transfers if a sequential access pattern is
detected. This can improve the performance on some systems.
-.. COMMENT: === CONFIGURE_BDBUF_MAX_WRITE_BLOCKS ===
-
-.. _Maximum Blocks per Write Request:
+.. _CONFIGURE_BDBUF_MAX_WRITE_BLOCKS:
-Maximum Blocks per Write Request
+CONFIGURE_BDBUF_MAX_WRITE_BLOCKS
--------------------------------
.. index:: CONFIGURE_BDBUF_MAX_WRITE_BLOCKS
@@ -3020,12 +2816,10 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === CONFIGURE_BDBUF_TASK_STACK_SIZE ===
-
-.. _Task Stack Size of the Block Device Cache Tasks:
+.. _CONFIGURE_BDBUF_TASK_STACK_SIZE:
-Task Stack Size of the Block Device Cache Tasks
------------------------------------------------
+CONFIGURE_BDBUF_TASK_STACK_SIZE
+-------------------------------
.. index:: CONFIGURE_BDBUF_TASK_STACK_SIZE
CONSTANT:
@@ -3046,12 +2840,10 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === CONFIGURE_BDBUF_READ_AHEAD_TASK_PRIORITY ===
-
-.. _Read-Ahead Task Priority:
+.. _CONFIGURE_BDBUF_READ_AHEAD_TASK_PRIORITY:
-Read-Ahead Task Priority
-------------------------
+CONFIGURE_BDBUF_READ_AHEAD_TASK_PRIORITY
+----------------------------------------
.. index:: CONFIGURE_BDBUF_READ_AHEAD_TASK_PRIORITY
CONSTANT:
@@ -3072,12 +2864,10 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === CONFIGURE_SWAPOUT_WORKER_TASKS ===
+.. _CONFIGURE_SWAPOUT_WORKER_TASKS:
-.. _Swapout Worker Task Count:
-
-Swapout Worker Task Count
--------------------------
+CONFIGURE_SWAPOUT_WORKER_TASKS
+------------------------------
.. index:: CONFIGURE_SWAPOUT_WORKER_TASKS
CONSTANT:
@@ -3098,12 +2888,10 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === CONFIGURE_SWAPOUT_WORKER_TASK_PRIORITY ===
-
-.. _Swapout Worker Task Priority:
+.. _CONFIGURE_SWAPOUT_WORKER_TASK_PRIORITY:
-Swapout Worker Task Priority
-----------------------------
+CONFIGURE_SWAPOUT_WORKER_TASK_PRIORITY
+--------------------------------------
.. index:: CONFIGURE_SWAPOUT_WORKER_TASK_PRIORITY
CONSTANT:
@@ -3124,8 +2912,6 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === BSP Specific Settings ===
-
BSP Specific Settings
=====================
@@ -3133,12 +2919,10 @@ This section describes BSP specific configuration settings used by
``<rtems/confdefs.h>``. The BSP specific configuration settings are defined in
``<bsp.h>``.
-.. COMMENT: === Disable BSP Settings ===
-
-.. _Disable BSP Configuration Settings:
+.. _CONFIGURE_DISABLE_BSP_SETTINGS:
-Disable BSP Configuration Settings
-----------------------------------
+CONFIGURE_DISABLE_BSP_SETTINGS
+------------------------------
.. index:: CONFIGURE_DISABLE_BSP_SETTINGS
CONSTANT:
@@ -3160,12 +2944,10 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === CONFIGURE_MALLOC_BSP_SUPPORTS_SBRK ===
-
-.. _Specify BSP Supports sbrk():
+.. _CONFIGURE_MALLOC_BSP_SUPPORTS_SBRK:
-Specify BSP Supports sbrk()
----------------------------
+CONFIGURE_MALLOC_BSP_SUPPORTS_SBRK
+----------------------------------
.. index:: CONFIGURE_MALLOC_BSP_SUPPORTS_SBRK
CONSTANT:
@@ -3192,12 +2974,10 @@ NOTES:
This parameter should not be defined by the application. Only the BSP knows
how it allocates memory to the C Program Heap.
-.. COMMENT: === BSP_IDLE_TASK_BODY ===
-
-.. _Specify BSP Specific Idle Task:
+.. _BSP_IDLE_TASK_BODY:
-Specify BSP Specific Idle Task
-------------------------------
+BSP_IDLE_TASK_BODY
+------------------
.. index:: BSP_IDLE_TASK_BODY
CONSTANT:
@@ -3222,12 +3002,10 @@ NOTES:
peripheral buses, a BSP specific IDLE task may be capable of turning
components off to save power during extended periods of no task activity
-.. COMMENT: === BSP_IDLE_TASK_STACK_SIZE ===
-
-.. _Specify BSP Suggested Value for IDLE Task Stack Size:
+.. _BSP_IDLE_TASK_STACK_SIZE:
-Specify BSP Suggested Value for IDLE Task Stack Size
-----------------------------------------------------
+BSP_IDLE_TASK_STACK_SIZE
+------------------------
.. index:: BSP_IDLE_TASK_STACK_SIZE
CONSTANT:
@@ -3260,12 +3038,10 @@ NOTES:
.. COMMENT: XXX - add cross references to other related values.
-.. COMMENT: === BSP_INITIAL_EXTENSION ===
+.. _BSP_INITIAL_EXTENSION:
-.. _Specify BSP Specific User Extensions:
-
-Specify BSP Specific User Extensions
-------------------------------------
+BSP_INITIAL_EXTENSION
+---------------------
.. index:: BSP_INITIAL_EXTENSION
CONSTANT:
@@ -3288,12 +3064,10 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === BSP_INTERRUPT_STACK_SIZE ===
+.. _BSP_INTERRUPT_STACK_SIZE:
-.. _Specifying BSP Specific Interrupt Stack Size:
-
-Specifying BSP Specific Interrupt Stack Size
---------------------------------------------
+BSP_INTERRUPT_STACK_SIZE
+------------------------
.. index:: BSP_INTERRUPT_STACK_SIZE
CONSTANT:
@@ -3316,12 +3090,10 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === BSP_MAXIMUM_DEVICES ===
-
-.. _Specifying BSP Specific Maximum Devices:
+.. _BSP_MAXIMUM_DEVICES:
-Specifying BSP Specific Maximum Devices
----------------------------------------
+BSP_MAXIMUM_DEVICES
+-------------------
.. index:: BSP_MAXIMUM_DEVICES
CONSTANT:
@@ -3347,12 +3119,10 @@ NOTES:
only impacts the devFS and thus is only used by ``<rtems/confdefs.h>`` when
``CONFIGURE_USE_DEVFS_AS_BASE_FILESYSTEM`` is specified.
-.. COMMENT: === BSP_ZERO_WORKSPACE_AUTOMATICALLY ===
-
-.. _BSP Recommends RTEMS Workspace be Cleared:
+.. _BSP_ZERO_WORKSPACE_AUTOMATICALLY:
-BSP Recommends RTEMS Workspace be Cleared
------------------------------------------
+BSP_ZERO_WORKSPACE_AUTOMATICALLY
+--------------------------------
.. index:: BSP_ZERO_WORKSPACE_AUTOMATICALLY
CONSTANT:
@@ -3376,12 +3146,10 @@ NOTES:
Zeroing memory can add significantly to system boot time. It is not
necessary for RTEMS but is often assumed by support libraries.
-.. COMMENT: === CONFIGURE_BSP_PREREQUISITE_DRIVERS ===
-
-.. _Specify BSP Prerequisite Drivers:
+.. _CONFIGURE_BSP_PREREQUISITE_DRIVERS:
-Specify BSP Prerequisite Drivers
---------------------------------
+CONFIGURE_BSP_PREREQUISITE_DRIVERS
+----------------------------------
.. index:: CONFIGURE_BSP_PREREQUISITE_DRIVERS
CONSTANT:
@@ -3408,20 +3176,16 @@ NOTES:
configure common infrastructure such as bus controllers or probe for
devices.
-.. COMMENT: === Idle Task Configuration ===
-
Idle Task Configuration
=======================
This section defines the IDLE task related configuration parameters supported
by ``<rtems/confdefs.h>``.
-.. COMMENT: === CONFIGURE_IDLE_TASK_BODY ===
+.. _CONFIGURE_IDLE_TASK_BODY:
-.. _Specify Application Specific Idle Task Body:
-
-Specify Application Specific Idle Task Body
--------------------------------------------
+CONFIGURE_IDLE_TASK_BODY
+------------------------
.. index:: CONFIGURE_IDLE_TASK_BODY
CONSTANT:
@@ -3444,12 +3208,10 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === CONFIGURE_IDLE_TASK_STACK_SIZE ===
+.. _CONFIGURE_IDLE_TASK_STACK_SIZE:
-.. _Specify Idle Task Stack Size:
-
-Specify Idle Task Stack Size
-----------------------------
+CONFIGURE_IDLE_TASK_STACK_SIZE
+------------------------------
.. index:: CONFIGURE_IDLE_TASK_STACK_SIZE
CONSTANT:
@@ -3471,12 +3233,10 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === CONFIGURE_IDLE_TASK_INITIALIZES_APPLICATION ===
+.. _CONFIGURE_IDLE_TASK_INITIALIZES_APPLICATION:
-.. _Specify Idle Task Performs Application Initialization:
-
-Specify Idle Task Performs Application Initialization
------------------------------------------------------
+CONFIGURE_IDLE_TASK_INITIALIZES_APPLICATION
+-------------------------------------------
.. index:: CONFIGURE_IDLE_TASK_INITIALIZES_APPLICATION
CONSTANT:
@@ -3506,8 +3266,6 @@ NOTES:
The IDLE task must run at the lowest priority of all tasks in the system.
-.. COMMENT: === Scheduler Algorithm Configuration ===
-
Scheduler Algorithm Configuration
=================================
@@ -3521,12 +3279,10 @@ The pluggable scheduler interface also enables the user to provide their own
scheduling algorithm. If you choose to do this, you must define multiple
configuration macros.
-.. COMMENT: === CONFIGURE_SCHEDULER_PRIORITY ===
+.. _CONFIGURE_SCHEDULER_PRIORITY:
-.. _Use Deterministic Priority Scheduler:
-
-Use Deterministic Priority Scheduler
-------------------------------------
+CONFIGURE_SCHEDULER_PRIORITY
+----------------------------
.. index:: CONFIGURE_SCHEDULER_PRIORITY
CONSTANT:
@@ -3554,12 +3310,10 @@ NOTES:
``CONFIGURE_SCHEDULER_PRIORITY`` although this is equivalent to the default
behavior.
-.. COMMENT: === CONFIGURE_SCHEDULER_SIMPLE ===
+.. _CONFIGURE_SCHEDULER_SIMPLE:
-.. _Use Simple Priority Scheduler:
-
-Use Simple Priority Scheduler
------------------------------
+CONFIGURE_SCHEDULER_SIMPLE
+--------------------------
.. index:: CONFIGURE_SCHEDULER_SIMPLE
CONSTANT:
@@ -3589,12 +3343,10 @@ DESCRIPTION:
NOTES:
This scheduler is appropriate for use in small systems where RAM is limited.
-.. COMMENT: === CONFIGURE_SCHEDULER_EDF ===
+.. _CONFIGURE_SCHEDULER_EDF:
-.. _Use Earliest Deadline First Scheduler:
-
-Use Earliest Deadline First Scheduler
--------------------------------------
+CONFIGURE_SCHEDULER_EDF
+-----------------------
.. index:: CONFIGURE_SCHEDULER_EDF
CONSTANT:
@@ -3626,12 +3378,10 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === CONFIGURE_SCHEDULER_EDF_SMP ===
-
-.. _Use Earliest Deadline First SMP Scheduler:
+.. _CONFIGURE_SCHEDULER_EDF_SMP:
-Use Earliest Deadline First Scheduler
--------------------------------------
+CONFIGURE_SCHEDULER_EDF_SMP
+---------------------------
.. index:: CONFIGURE_SCHEDULER_EDF_SMP
CONSTANT:
@@ -3653,12 +3403,10 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === CONFIGURE_SCHEDULER_CBS ===
-
-.. _Use Constant Bandwidth Server Scheduler:
+.. _CONFIGURE_SCHEDULER_CBS:
-Use Constant Bandwidth Server Scheduler
----------------------------------------
+CONFIGURE_SCHEDULER_CBS
+-----------------------
.. index:: CONFIGURE_SCHEDULER_CBS
CONSTANT:
@@ -3683,17 +3431,13 @@ DESCRIPTION:
This scheduler may be explicitly selected by defining
``CONFIGURE_SCHEDULER_CBS``.
-.. COMMENT: XXX - add cross reference to API chapter
-
NOTES:
None.
-.. COMMENT: === CONFIGURE_SCHEDULER_PRIORITY_SMP ===
+.. _CONFIGURE_SCHEDULER_PRIORITY_SMP:
-.. _Use Deterministic Priority SMP Scheduler:
-
-Use Deterministic Priority SMP Scheduler
-----------------------------------------
+CONFIGURE_SCHEDULER_PRIORITY_SMP
+--------------------------------
.. index:: CONFIGURE_SCHEDULER_PRIORITY_SMP
CONSTANT:
@@ -3723,12 +3467,10 @@ NOTES:
This scheduler is currently the default in SMP configurations and is only
selected when ``CONFIGURE_MAXIMUM_PROCESSORS`` is greater than one.
-.. COMMENT: === CONFIGURE_SCHEDULER_SIMPLE_SMP ===
+.. _CONFIGURE_SCHEDULER_SIMPLE_SMP:
-.. _Use Simple SMP Priority Scheduler:
-
-Use Simple SMP Priority Scheduler
----------------------------------
+CONFIGURE_SCHEDULER_SIMPLE_SMP
+------------------------------
.. index:: CONFIGURE_SCHEDULER_SIMPLE_SMP
CONSTANT:
@@ -3764,12 +3506,10 @@ NOTES:
This scheduler is only available when RTEMS is configured with SMP support
enabled.
-.. COMMENT: === Configuring a Scheduler Name ===
+.. _CONFIGURE_SCHEDULER_NAME:
-.. _Configuring a Scheduler Name:
-
-Configuring a Scheduler Name
-----------------------------
+CONFIGURE_SCHEDULER_NAME
+------------------------
.. index:: CONFIGURE_SCHEDULER_NAME
CONSTANT:
@@ -3798,12 +3538,10 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === Configuring a User Scheduler ===
+.. _CONFIGURE_SCHEDULER_USER:
-.. _Configuring a User Provided Scheduler:
-
-Configuring a User Provided Scheduler
--------------------------------------
+CONFIGURE_SCHEDULER_USER
+------------------------
.. index:: CONFIGURE_SCHEDULER_USER
CONSTANT:
@@ -3842,8 +3580,6 @@ NOTES:
the configuration macros, please examine ``cpukit/sapi/include/confdefs.h``
for how these are defined for the Deterministic Priority Scheduler.
-.. COMMENT: === Configuring Clustered Schedulers ===
-
.. _Configuring Clustered Schedulers:
Configuring Clustered Schedulers
@@ -4015,8 +3751,6 @@ EXAMPLE:
RTEMS_SCHEDULER_ASSIGN(1, RTEMS_SCHEDULER_ASSIGN_PROCESSOR_OPTIONAL), \
RTEMS_SCHEDULER_ASSIGN(1, RTEMS_SCHEDULER_ASSIGN_PROCESSOR_OPTIONAL)
-.. COMMENT: === Device Driver Table ===
-
Device Driver Table
===================
@@ -4027,12 +3761,10 @@ suitable for simple applications with no custom device drivers.
Note that network device drivers are not configured in the Device Driver Table.
-.. COMMENT: === CONFIGURE_MAXIMUM_DRIVERS ===
-
-.. _Specifying the Maximum Number of Device Drivers:
+.. _CONFIGURE_MAXIMUM_DRIVERS:
-Specifying the Maximum Number of Device Drivers
------------------------------------------------
+CONFIGURE_MAXIMUM_DRIVERS
+-------------------------
.. index:: CONFIGURE_MAXIMUM_DRIVERS
CONSTANT:
@@ -4061,12 +3793,10 @@ NOTES:
``CONFIGURE_APPLICATIONS_NEEDS_XXX_DRIVER`` configuration parameters are
statically installed.
-.. COMMENT: === CONFIGURE_APPLICATION_NEEDS_CONSOLE_DRIVER ===
-
-.. _Enable Console Device Driver:
+.. _CONFIGURE_APPLICATION_NEEDS_CONSOLE_DRIVER:
-Enable Console Device Driver
-----------------------------
+CONFIGURE_APPLICATION_NEEDS_CONSOLE_DRIVER
+------------------------------------------
.. index:: CONFIGURE_APPLICATION_NEEDS_CONSOLE_DRIVER
CONSTANT:
@@ -4092,12 +3822,10 @@ NOTES:
BSPs should be constructed in a manner that allows ``printk()`` to work
properly without the need for the console driver to be configured.
-.. COMMENT: === CONFIGURE_APPLICATION_NEEDS_CLOCK_DRIVER ===
-
-.. _Enable Clock Driver:
+.. _CONFIGURE_APPLICATION_NEEDS_CLOCK_DRIVER:
-Enable Clock Driver
--------------------
+CONFIGURE_APPLICATION_NEEDS_CLOCK_DRIVER
+----------------------------------------
.. index:: CONFIGURE_APPLICATION_NEEDS_CLOCK_DRIVER
CONSTANT:
@@ -4125,12 +3853,10 @@ NOTES:
``CONFIGURE_APPLICATION_DOES_NOT_NEED_CLOCK_DRIVER`` is not defined, then a
compile time error will occur.
-.. COMMENT: === CONFIGURE_APPLICATION_NEEDS_TIMER_DRIVER ===
-
-.. _Enable the Benchmark Timer Driver:
+.. _CONFIGURE_APPLICATION_NEEDS_TIMER_DRIVER:
-Enable the Benchmark Timer Driver
----------------------------------
+CONFIGURE_APPLICATION_NEEDS_TIMER_DRIVER
+----------------------------------------
.. index:: CONFIGURE_APPLICATION_NEEDS_TIMER_DRIVER
CONSTANT:
@@ -4156,12 +3882,10 @@ NOTES:
``CONFIGURE_APPLICATION_DOES_NOT_NEED_CLOCK_DRIVER`` is not defined, then a
compile time error will occur.
-.. COMMENT: === CONFIGURE_APPLICATION_DOES_NOT_NEED_CLOCK_DRIVER ===
-
-.. _Specify Clock and Benchmark Timer Drivers Are Not Needed:
+.. _CONFIGURE_APPLICATION_DOES_NOT_NEED_CLOCK_DRIVER:
-Specify Clock and Benchmark Timer Drivers Are Not Needed
---------------------------------------------------------
+CONFIGURE_APPLICATION_DOES_NOT_NEED_CLOCK_DRIVER
+------------------------------------------------
.. index:: CONFIGURE_APPLICATION_DOES_NOT_NEED_CLOCK_DRIVER
CONSTANT:
@@ -4187,12 +3911,10 @@ NOTES:
of using the Hello World example as the baseline for an application and
leaving out a clock tick source.
-.. COMMENT: === CONFIGURE_APPLICATION_NEEDS_RTC_DRIVER ===
-
-.. _Enable Real-Time Clock Driver:
+.. _CONFIGURE_APPLICATION_NEEDS_RTC_DRIVER:
-Enable Real-Time Clock Driver
------------------------------
+CONFIGURE_APPLICATION_NEEDS_RTC_DRIVER
+--------------------------------------
.. index:: CONFIGURE_APPLICATION_NEEDS_RTC_DRIVER
CONSTANT:
@@ -4218,12 +3940,10 @@ NOTES:
If this is defined and the BSP does not have this device driver, then the
user will get a link time error for an undefined symbol.
-.. COMMENT: === CONFIGURE_APPLICATION_NEEDS_WATCHDOG_DRIVER ===
-
-.. _Enable the Watchdog Device Driver:
+.. _CONFIGURE_APPLICATION_NEEDS_WATCHDOG_DRIVER:
-Enable the Watchdog Device Driver
----------------------------------
+CONFIGURE_APPLICATION_NEEDS_WATCHDOG_DRIVER
+-------------------------------------------
.. index:: CONFIGURE_APPLICATION_NEEDS_WATCHDOG_DRIVER
CONSTANT:
@@ -4249,12 +3969,10 @@ NOTES:
If this is defined and the BSP does not have this device driver, then the
user will get a link time error for an undefined symbol.
-.. COMMENT: === CONFIGURE_APPLICATION_NEEDS_FRAME_BUFFER_DRIVER ===
-
-.. _Enable the Graphics Frame Buffer Device Driver:
+.. _CONFIGURE_APPLICATION_NEEDS_FRAME_BUFFER_DRIVER:
-Enable the Graphics Frame Buffer Device Driver
-----------------------------------------------
+CONFIGURE_APPLICATION_NEEDS_FRAME_BUFFER_DRIVER
+-----------------------------------------------
.. index:: CONFIGURE_APPLICATION_NEEDS_FRAME_BUFFER_DRIVER
CONSTANT:
@@ -4280,12 +3998,10 @@ NOTES:
If this is defined and the BSP does not have this device driver, then the
user will get a link time error for an undefined symbol.
-.. COMMENT: === CONFIGURE_APPLICATION_NEEDS_STUB_DRIVER ===
+.. _CONFIGURE_APPLICATION_NEEDS_STUB_DRIVER:
-.. _Enable Stub Device Driver:
-
-Enable Stub Device Driver
--------------------------
+CONFIGURE_APPLICATION_NEEDS_STUB_DRIVER
+---------------------------------------
.. index:: CONFIGURE_APPLICATION_NEEDS_STUB_DRIVER
CONSTANT:
@@ -4308,12 +4024,10 @@ NOTES:
This device driver simply provides entry points that return successful and
is primarily a test fixture. It is supported by all BSPs.
-.. COMMENT: === CONFIGURE_APPLICATION_PREREQUISITE_DRIVERS ===
+.. _CONFIGURE_APPLICATION_PREREQUISITE_DRIVERS:
-.. _Specify Application Prerequisite Device Drivers:
-
-Specify Application Prerequisite Device Drivers
------------------------------------------------
+CONFIGURE_APPLICATION_PREREQUISITE_DRIVERS
+------------------------------------------
.. index:: CONFIGURE_APPLICATION_PREREQUISITE_DRIVERS
CONSTANT:
@@ -4344,12 +4058,10 @@ NOTES:
.. COMMENT: XXX Add example
-.. COMMENT: === CONFIGURE_APPLICATION_EXTRA_DRIVERS ===
-
-.. _Specify Extra Application Device Drivers:
+.. _CONFIGURE_APPLICATION_EXTRA_DRIVERS:
-Specify Extra Application Device Drivers
-----------------------------------------
+CONFIGURE_APPLICATION_EXTRA_DRIVERS
+-----------------------------------
.. index:: CONFIGURE_APPLICATION_EXTRA_DRIVERS
CONSTANT:
@@ -4373,12 +4085,10 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === CONFIGURE_APPLICATION_NEEDS_NULL_DRIVER ===
-
-.. _Enable /dev/null Device Driver:
+.. _CONFIGURE_APPLICATION_NEEDS_NULL_DRIVER:
-Enable /dev/null Device Driver
-------------------------------
+CONFIGURE_APPLICATION_NEEDS_NULL_DRIVER
+---------------------------------------
.. index:: CONFIGURE_APPLICATION_NEEDS_NULL_DRIVER
.. index:: /dev/null
@@ -4400,12 +4110,10 @@ DESCRIPTION:
NOTES:
This device driver is supported by all BSPs.
-.. COMMENT: === CONFIGURE_APPLICATION_NEEDS_ZERO_DRIVER ===
-
-.. _Enable /dev/zero Device Driver:
+.. _CONFIGURE_APPLICATION_NEEDS_ZERO_DRIVER:
-Enable /dev/zero Device Driver
-------------------------------
+CONFIGURE_APPLICATION_NEEDS_ZERO_DRIVER
+---------------------------------------
.. index:: CONFIGURE_APPLICATION_NEEDS_ZERO_DRIVER
.. index:: /dev/zero
@@ -4427,12 +4135,10 @@ DESCRIPTION:
NOTES:
This device driver is supported by all BSPs.
-.. COMMENT: === CONFIGURE_HAS_OWN_DEVICE_DRIVER_TABLE ===
-
-.. _Specifying Application Defined Device Driver Table:
+.. _CONFIGURE_HAS_OWN_DEVICE_DRIVER_TABLE:
-Specifying Application Defined Device Driver Table
---------------------------------------------------
+CONFIGURE_HAS_OWN_DEVICE_DRIVER_TABLE
+-------------------------------------
.. index:: CONFIGURE_HAS_OWN_DEVICE_DRIVER_TABLE
CONSTANT:
@@ -4460,8 +4166,6 @@ DESCRIPTION:
NOTES:
It is expected that there the application would only rarely need to do this.
-.. COMMENT: === Multiprocessing Configuration ===
-
Multiprocessing Configuration
=============================
@@ -4473,12 +4177,10 @@ time using the ``--enable-multiprocessing`` option.
Additionally, this class of Configuration Constants are only applicable if
``CONFIGURE_MP_APPLICATION`` is defined.
-.. COMMENT: === CONFIGURE_MP_APPLICATION ===
-
-.. _Specify Application Will Use Multiprocessing:
+.. _CONFIGURE_MP_APPLICATION:
-Specify Application Will Use Multiprocessing
---------------------------------------------
+CONFIGURE_MP_APPLICATION
+------------------------
.. index:: CONFIGURE_MP_APPLICATION
CONSTANT:
@@ -4503,12 +4205,10 @@ NOTES:
This has no impact unless RTEMS was configured and built using the
``--enable-multiprocessing`` option.
-.. COMMENT: === CONFIGURE_MP_NODE_NUMBER ===
-
-.. _Configure Node Number in Multiprocessor Configuration:
+.. _CONFIGURE_MP_NODE_NUMBER:
-Configure Node Number in Multiprocessor Configuration
------------------------------------------------------
+CONFIGURE_MP_NODE_NUMBER
+------------------------
.. index:: CONFIGURE_MP_NODE_NUMBER
CONSTANT:
@@ -4534,12 +4234,10 @@ NOTES:
``NODE_NUMBER`` set to different values. The test programs behave
differently based upon their node number.
-.. COMMENT: === CONFIGURE_MP_MAXIMUM_NODES ===
+.. _CONFIGURE_MP_MAXIMUM_NODES:
-.. _Configure Maximum Node in Multiprocessor Configuration:
-
-Configure Maximum Node in Multiprocessor Configuration
-------------------------------------------------------
+CONFIGURE_MP_MAXIMUM_NODES
+--------------------------
.. index:: CONFIGURE_MP_MAXIMUM_NODES
CONSTANT:
@@ -4561,12 +4259,10 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS ===
-
-.. _Configure Maximum Global Objects in Multiprocessor Configuration:
+.. _CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS:
-Configure Maximum Global Objects in Multiprocessor Configuration
-----------------------------------------------------------------
+CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS
+-----------------------------------
.. index:: CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS
CONSTANT:
@@ -4589,12 +4285,10 @@ NOTES:
This value corresponds to the total number of objects which can be created
with the ``RTEMS_GLOBAL`` attribute.
-.. COMMENT: === CONFIGURE_MP_MAXIMUM_PROXIES ===
-
-.. _Configure Maximum Proxies in Multiprocessor Configuration:
+.. _CONFIGURE_MP_MAXIMUM_PROXIES:
-Configure Maximum Proxies in Multiprocessor Configuration
----------------------------------------------------------
+CONFIGURE_MP_MAXIMUM_PROXIES
+----------------------------
.. index:: CONFIGURE_MP_MAXIMUM_PROXIES
CONSTANT:
@@ -4620,12 +4314,10 @@ NOTES:
.. COMMENT: XXX - add xref to proxy discussion in MP chapter
-.. COMMENT: === CONFIGURE_MP_MPCI_TABLE_POINTER ===
+.. _CONFIGURE_MP_MPCI_TABLE_POINTER:
-.. _Configure MPCI in Multiprocessor Configuration:
-
-Configure MPCI in Multiprocessor Configuration
-----------------------------------------------
+CONFIGURE_MP_MPCI_TABLE_POINTER
+-------------------------------
.. index:: CONFIGURE_MP_MPCI_TABLE_POINTER
CONSTANT:
@@ -4649,12 +4341,10 @@ NOTES:
Multiprocessor System assuming the BSP provides the proper set of
supporting methods.
-.. COMMENT: === CONFIGURE_HAS_OWN_MULTIPROCESSING_TABLE ===
-
-.. _Do Not Generate Multiprocessor Configuration Table:
+.. _CONFIGURE_HAS_OWN_MULTIPROCESSING_TABLE:
-Do Not Generate Multiprocessor Configuration Table
---------------------------------------------------
+CONFIGURE_HAS_OWN_MULTIPROCESSING_TABLE
+---------------------------------------
.. index:: CONFIGURE_HAS_OWN_MULTIPROCESSING_TABLE
CONSTANT:
@@ -4679,8 +4369,6 @@ NOTES:
application. If you find yourself wanting to use it in an application,
please reconsider and discuss this on the RTEMS Users mailing list.
-.. COMMENT: === Ada Tasks ===
-
Ada Tasks
=========
@@ -4696,12 +4384,10 @@ Additionally RTEMS includes an Ada language binding to the Classic API which
has a test suite. This test suite is enabled only when``--enable-tests`` and
``--enable-expada`` are specified on the configure command.
-.. COMMENT: === CONFIGURE_GNAT_RTEMS ===
-
-.. _Specify Application Includes Ada Code:
+.. _CONFIGURE_GNAT_RTEMS:
-Specify Application Includes Ada Code
--------------------------------------
+CONFIGURE_GNAT_RTEMS
+--------------------
.. index:: CONFIGURE_GNAT_RTEMS
CONSTANT:
@@ -4725,12 +4411,10 @@ NOTES:
configure the resources (POSIX API Threads, Mutexes, Condition Variables,
and Keys) used implicitly by the GNAT run-time.
-.. COMMENT: === CONFIGURE_MAXIMUM_ADA_TASKS ===
-
-.. _Specify the Maximum Number of Ada Tasks.:
+.. _CONFIGURE_MAXIMUM_ADA_TASKS:
-Specify the Maximum Number of Ada Tasks.
-----------------------------------------
+CONFIGURE_MAXIMUM_ADA_TASKS
+---------------------------
.. index:: CONFIGURE_MAXIMUM_ADA_TASKS
CONSTANT:
@@ -4753,12 +4437,10 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === CONFIGURE_MAXIMUM_FAKE_ADA_TASKS ===
-
-.. _Specify the Maximum Fake Ada Tasks:
+.. _CONFIGURE_MAXIMUM_FAKE_ADA_TASKS:
-Specify the Maximum Fake Ada Tasks
-----------------------------------
+CONFIGURE_MAXIMUM_FAKE_ADA_TASKS
+--------------------------------
.. index:: CONFIGURE_MAXIMUM_FAKE_ADA_TASKS
CONSTANT:
@@ -4782,8 +4464,6 @@ DESCRIPTION:
NOTES:
None.
-.. COMMENT: === PCI Library ===
-
PCI Library
===========
@@ -4836,17 +4516,13 @@ Note that selecting ``PCI_LIB_STATIC`` or ``PCI_LIB_PERIPHERAL`` but not
defining ``pci_hb`` will reuslt in link errors. Note also that in these modes
Plug & Play is not performed.
-.. COMMENT: === Go Tasks ===
-
Go Tasks
========
-.. COMMENT: === CONFIGURE_ENABLE_GO ===
+.. _CONFIGURE_ENABLE_GO:
-.. _Specify Application Includes Go Code:
-
-Specify Application Includes Go Code
-------------------------------------
+CONFIGURE_ENABLE_GO
+-------------------
.. index:: CONFIGURE_ENABLE_GO
CONSTANT:
@@ -4868,12 +4544,10 @@ DESCRIPTION:
NOTES:
The Go language support is experimental
-.. COMMENT: === CONFIGURE_MAXIMUM_GOROUTINES ===
+.. _CONFIGURE_MAXIMUM_GOROUTINES:
-.. _Specify the maximum number of Go routines:
-
-Specify the maximum number of Go routines
------------------------------------------
+CONFIGURE_MAXIMUM_GOROUTINES
+----------------------------
.. index:: CONFIGURE_MAXIMUM_GOROUTINES
CONSTANT:
@@ -4895,12 +4569,10 @@ DESCRIPTION:
NOTES:
The Go language support is experimental
-.. COMMENT: === CONFIGURE_MAXIMUM_GO_CHANNELS ===
+.. _CONFIGURE_MAXIMUM_GO_CHANNELS:
-.. _Specify the maximum number of Go Channels:
-
-Specify the maximum number of Go Channels
------------------------------------------
+CONFIGURE_MAXIMUM_GO_CHANNELS
+-----------------------------
.. index:: CONFIGURE_MAXIMUM_GO_CHANNELS
CONSTANT:
--
2.12.3
More information about the devel
mailing list