[rtems-docs commit] c-user: CONFIGURE_MAXIMUM_POSIX_SEMAPHORES

[Sebastian Huber]

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

Author:    Sebastian Huber <sebastian.huber at embedded-brains.de>
Date:      Wed Oct 11 07:58:39 2017 +0200

c-user: CONFIGURE_MAXIMUM_POSIX_SEMAPHORES

This configuration is not obsolete since it is still used for named
semaphores.

Update #3116.

---

 c-user/configuring_a_system.rst | 36 ++++++++++++++++++++++++++++++------
 1 file changed, 30 insertions(+), 6 deletions(-)

diff --git a/c-user/configuring_a_system.rst b/c-user/configuring_a_system.rst
index 01904a1..c91c8b6 100644
--- a/c-user/configuring_a_system.rst
+++ b/c-user/configuring_a_system.rst
@@ -1292,6 +1292,36 @@ DESCRIPTION:
 NOTES:
     This object class can be configured in unlimited allocation mode.
 
+.. COMMENT: === CONFIGURE_MAXIMUM_POSIX_SEMAPHORES ===
+
+.. _Specify Maximum POSIX API Semaphores:
+
+Specify Maximum POSIX API Named Semaphores
+------------------------------------------
+.. index:: CONFIGURE_MAXIMUM_POSIX_SEMAPHORES
+
+CONSTANT:
+    ``CONFIGURE_MAXIMUM_POSIX_SEMAPHORES``
+
+DATA TYPE:
+    Unsigned integer (``uint32_t``).
+
+RANGE:
+    Zero or positive.
+
+DEFAULT VALUE:
+    The default value is 0.
+
+DESCRIPTION:
+    ``CONFIGURE_MAXIMUM_POSIX_SEMAPHORES`` is the maximum number of POSIX API
+    Named Semaphores that can be concurrently active.  Named semaphores are
+    created with ``sem_open()``.  Semaphores initialized with ``sem_init()``
+    are not affected by this configuration option since the storage space for
+    these semaphores is user-provided.
+
+NOTES:
+    None.
+
 .. COMMENT: === POSIX Initialization Threads Table Configuration ===
 
 POSIX Initialization Threads Table Configuration
@@ -4986,12 +5016,6 @@ CONFIGURE_MAXIMUM_POSIX_RWLOCKS
 
 This configuration option is obsolete since RTEMS 4.12.
 
-CONFIGURE_MAXIMUM_POSIX_SEMAPHORES
-----------------------------------
-.. index:: CONFIGURE_MAXIMUM_POSIX_SEMAPHORES
-
-This configuration option is obsolete since RTEMS 4.12.
-
 CONFIGURE_MAXIMUM_POSIX_SPINLOCKS
 ---------------------------------
 .. index:: CONFIGURE_MAXIMUM_POSIX_SPINLOCKS