[rtems-docs commit] c-user: CONFIGURE_MAXIMUM_PROCESSORS

[Sebastian Huber]

Module:    rtems-docs
Branch:    master
Commit:    1d073c538527a196cc35dab9d4ff6892e70d770d
Changeset: http://git.rtems.org/rtems-docs/commit/?id=1d073c538527a196cc35dab9d4ff6892e70d770d

Author:    Sebastian Huber <sebastian.huber at embedded-brains.de>
Date:      Tue Feb 14 10:18:25 2017 +0100

c-user: CONFIGURE_MAXIMUM_PROCESSORS

Update #2894.

---

 c-user/configuring_a_system.rst               | 76 +++++++++++++--------------
 c-user/semaphore_manager.rst                  |  2 +-
 c-user/symmetric_multiprocessing_services.rst |  6 +--
 3 files changed, 40 insertions(+), 44 deletions(-)

diff --git a/c-user/configuring_a_system.rst b/c-user/configuring_a_system.rst
index 47a9812..71c5c71 100644
--- a/c-user/configuring_a_system.rst
+++ b/c-user/configuring_a_system.rst
@@ -1647,6 +1647,39 @@ 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
+----------------------------------------
+.. index:: CONFIGURE_MAXIMUM_PROCESSORS
+
+CONSTANT:
+    ``CONFIGURE_MAXIMUM_PROCESSORS``
+
+DATA TYPE:
+    Unsigned integer (``uint32_t``).
+
+RANGE:
+    Positive.
+
+DEFAULT VALUE:
+    The default value is 1.
+
+DESCRIPTION:
+    ``CONFIGURE_MAXIMUM_PROCESSORS`` must be set to the maximum number of
+    processors an applicaiton intends to use.  The number of acually available
+    processors depends on the hardware and may be less.  It is recommended to
+    use the smallest value suitable for the application in order to save
+    memory.  Each processor needs an idle thread and interrupt stack for
+    example.
+
+NOTES:
+    If there are more processors available than configured, the rest will be
+    ignored.  This configuration define is ignored in uni-processor
+    configurations.
+
 .. COMMENT: === CONFIGURE_MICROSECONDS_PER_TICK ===
 
 .. _CONFIGURE_MICROSECONDS_PER_TICK:
@@ -3830,7 +3863,7 @@ NOTES:
     enabled.
 
     This scheduler is currently the default in SMP configurations and is only
-    selected when ``CONFIGURE_SMP_MAXIMUM_PROCESSORS`` is greater than one.
+    selected when ``CONFIGURE_MAXIMUM_PROCESSORS`` is greater than one.
 
 .. COMMENT: === CONFIGURE_SCHEDULER_SIMPLE_SMP ===
 
@@ -4020,7 +4053,7 @@ CONFIGURATION:
     The last step is to define which processor uses which scheduler.  For this
     purpose a scheduler assignment table must be defined.  The entry count of
     this table must be equal to the configured maximum processors
-    (``CONFIGURE_SMP_MAXIMUM_PROCESSORS``).  A processor assignment to a
+    (``CONFIGURE_MAXIMUM_PROCESSORS``).  A processor assignment to a
     scheduler can be optional or mandatory.  The boot processor must have a
     scheduler assigned.  In case the system needs more mandatory processors
     than available then a fatal run-time error will occur.  To specify the
@@ -4091,7 +4124,7 @@ EXAMPLE:
 
     .. code-block:: c
 
-        #define CONFIGURE_SMP_MAXIMUM_PROCESSORS 8
+        #define CONFIGURE_MAXIMUM_PROCESSORS 8
         #define CONFIGURE_MAXIMUM_PRIORITY 255
 
         /* Make the scheduler algorithm available */
@@ -4124,43 +4157,6 @@ EXAMPLE:
             RTEMS_SCHEDULER_ASSIGN(1, RTEMS_SCHEDULER_ASSIGN_PROCESSOR_OPTIONAL), \
             RTEMS_SCHEDULER_ASSIGN(1, RTEMS_SCHEDULER_ASSIGN_PROCESSOR_OPTIONAL)
 
-.. COMMENT: === SMP Specific Configuration Parameters ===
-
-SMP Specific Configuration Parameters
-=====================================
-
-When RTEMS is configured to support SMP target systems, there are other
-configuration parameters which apply.
-
-.. COMMENT: === CONFIGURE_SMP_MAXIMUM_PROCESSORS ===
-
-.. _CONFIGURE_SMP_MAXIMUM_PROCESSORS:
-
-Specify Maximum Processors in SMP System
-----------------------------------------
-.. index:: CONFIGURE_SMP_MAXIMUM_PROCESSORS
-
-CONSTANT:
-    ``CONFIGURE_SMP_MAXIMUM_PROCESSORS``
-
-DATA TYPE:
-    Unsigned integer (``uint32_t``).
-
-RANGE:
-    Defined or undefined.
-
-DEFAULT VALUE:
-    The default value is 1.
-
-DESCRIPTION:
-    ``CONFIGURE_SMP_MAXIMUM_PROCESSORS`` must be set to the number of
-    processors in the SMP configuration.
-
-NOTES:
-    If there are more processors available than configured, the rest will be
-    ignored.  This configuration define is ignored on uni-processor
-    configurations.
-
 .. COMMENT: === Device Driver Table ===
 
 Device Driver Table
diff --git a/c-user/semaphore_manager.rst b/c-user/semaphore_manager.rst
index 15523a2..58558a5 100644
--- a/c-user/semaphore_manager.rst
+++ b/c-user/semaphore_manager.rst
@@ -883,7 +883,7 @@ EXAMPLE:
         #define CONFIGURE_MAXIMUM_TASKS 1
         #define CONFIGURE_MAXIMUM_SEMAPHORES 1
         #define CONFIGURE_MAXIMUM_MRSP_SEMAPHORES 1
-        #define CONFIGURE_SMP_MAXIMUM_PROCESSORS 2
+        #define CONFIGURE_MAXIMUM_PROCESSORS 2
         #define CONFIGURE_SCHEDULER_SIMPLE_SMP
 
         #include <rtems/scheduler.h>
diff --git a/c-user/symmetric_multiprocessing_services.rst b/c-user/symmetric_multiprocessing_services.rst
index 6d468a5..2a2d669 100644
--- a/c-user/symmetric_multiprocessing_services.rst
+++ b/c-user/symmetric_multiprocessing_services.rst
@@ -45,9 +45,9 @@ Application Configuration
 
 By default, the maximum processor count is set to one in the application
 configuration.  To enable SMP, the application configuration option
-:ref:`CONFIGURE_SMP_MAXIMUM_PROCESSORS <CONFIGURE_SMP_MAXIMUM_PROCESSORS>` must
-be defined to a value greater than one.  It is recommended to use the smallest
-value suitable for the application in order to safe memory.  Each processor
+:ref:`CONFIGURE_MAXIMUM_PROCESSORS <CONFIGURE_MAXIMUM_PROCESSORS>` must be
+defined to a value greater than one.  It is recommended to use the smallest
+value suitable for the application in order to save memory.  Each processor
 needs an idle thread and interrupt stack for example.
 
 The default scheduler for SMP applications supports up to 32 processors and is