From dd1c262d2a3b632025d42d5f46e12c8c12fd9c46 Mon Sep 17 00:00:00 2001 From: Sebastian Huber Date: Tue, 30 Oct 2018 08:09:15 +0100 Subject: c-user: Update POSIX API configuration Close ##2514. --- c-user/configuring_a_system.rst | 33 ++++++++++++++++++++++----------- 1 file changed, 22 insertions(+), 11 deletions(-) (limited to 'c-user') diff --git a/c-user/configuring_a_system.rst b/c-user/configuring_a_system.rst index eab91ff..163f004 100644 --- a/c-user/configuring_a_system.rst +++ b/c-user/configuring_a_system.rst @@ -517,7 +517,7 @@ NOTES: ``CONFIGURE_EXTRA_TASK_STACKS``. The maximum number of POSIX threads is specified by - ``CONFIGURE_MAXIMUM_POSIX_THREADS``. + :ref:`CONFIGURE_MAXIMUM_POSIX_THREADS `. A future enhancement to ```` could be to eliminate the assumption that all tasks have floating point enabled. This would require @@ -1051,9 +1051,10 @@ NOTES: POSIX API Configuration ======================= -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. +The parameters in this section are used to configure resources for the POSIX +API supported by RTEMS. Most POSIX API objects are available by default since +RTEMS 5.1. The queued signals and timers are only available if RTEMS was built +with the ``--enable-posix`` build configuration option. .. index:: CONFIGURE_MAXIMUM_POSIX_KEYS @@ -1163,7 +1164,10 @@ DESCRIPTION: API Queued Signals that can be concurrently active. NOTES: - None. + Unlimited objects are not available for queued signals. + + Queued signals are only available if RTEMS was built with the + ``--enable-posix`` build configuration option. .. index:: CONFIGURE_MAXIMUM_POSIX_SEMAPHORES @@ -1186,13 +1190,14 @@ DEFAULT VALUE: 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. + Named Semaphores that can be concurrently active. NOTES: - None. + This object class can be configured in unlimited allocation mode. + + 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. .. index:: CONFIGURE_MAXIMUM_POSIX_TIMERS @@ -1220,6 +1225,9 @@ DESCRIPTION: NOTES: This object class can be configured in unlimited allocation mode. + Timers are only available if RTEMS was built with the + ``--enable-posix`` build configuration option. + .. index:: CONFIGURE_MAXIMUM_POSIX_THREADS .. _CONFIGURE_MAXIMUM_POSIX_THREADS: @@ -1255,7 +1263,7 @@ NOTES: ``CONFIGURE_EXTRA_TASK_STACKS``. The maximum number of Classic API Tasks is specified by - ``CONFIGURE_MAXIMUM_TASKS``. + :ref:`CONFIGURE_MAXIMUM_TASKS `. All POSIX threads have floating point enabled. @@ -1284,6 +1292,9 @@ DESCRIPTION: This configuration parameter defines the minimum stack size in bytes for every POSIX thread in the system. +NOTES: + None. + POSIX Initialization Threads Table Configuration ================================================ -- cgit v1.2.3