[rtems-docs commit] Document CONFIGURE_MAXIMUM_POSIX_KEY_VALUE_PAIRS

[Sebastian Huber]

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

Author:    Sebastian Huber <sebastian.huber at embedded-brains.de>
Date:      Tue Oct 30 07:46:39 2018 +0100

Document CONFIGURE_MAXIMUM_POSIX_KEY_VALUE_PAIRS

---

 c-user/configuring_a_system.rst | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/c-user/configuring_a_system.rst b/c-user/configuring_a_system.rst
index e622b91..eab91ff 100644
--- a/c-user/configuring_a_system.rst
+++ b/c-user/configuring_a_system.rst
@@ -1081,6 +1081,38 @@ DESCRIPTION:
 NOTES:
     This object class can be configured in unlimited allocation mode.
 
+.. index:: CONFIGURE_MAXIMUM_POSIX_KEY_VALUE_PAIRS
+
+.. _CONFIGURE_MAXIMUM_POSIX_KEY_VALUE_PAIRS
+
+CONFIGURE_MAXIMUM_POSIX_KEY_VALUE_PAIRS
+---------------------------------------
+
+CONSTANT:
+    ``CONFIGURE_MAXIMUM_POSIX_KEY_VALUE_PAIRS``
+
+DATA TYPE:
+    Unsigned integer (``uint32_t``).
+
+RANGE:
+    Zero or positive.
+
+DEFAULT VALUE:
+    The default value is
+    :ref:`CONFIGURE_MAXIMUM_POSIX_KEYS <CONFIGURE_MAXIMUM_POSIX_KEYS>` *
+    :ref:`CONFIGURE_MAXIMUM_TASKS <CONFIGURE_MAXIMUM_TASKS>` +
+    :ref:`CONFIGURE_MAXIMUM_POSIX_THREADS <CONFIGURE_MAXIMUM_POSIX_THREADS>`.
+
+DESCRIPTION:
+    ``CONFIGURE_MAXIMUM_POSIX_KEY_VALUE_PAIRS`` is the maximum number of key
+    value pairs used by POSIX API Keys that can be concurrently active.
+
+NOTES:
+    This object class can be configured in unlimited allocation mode.
+
+    A key value pair is created by :c:func:`pthread_setspecific` if the value
+    is not :c:macro:`NULL`, otherwise it is deleted.
+
 .. index:: CONFIGURE_MAXIMUM_POSIX_MESSAGE_QUEUES
 
 .. _CONFIGURE_MAXIMUM_POSIX_MESSAGE_QUEUES: