[rtems commit] doc: Fix SMP task variables section

Sebastian Huber sebh at rtems.org
Fri Jul 17 07:22:36 UTC 2015


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

Author:    Sebastian Huber <sebastian.huber at embedded-brains.de>
Date:      Fri Jul 17 09:16:37 2015 +0200

doc: Fix SMP task variables section

---

 doc/user/smp.t | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/doc/user/smp.t b/doc/user/smp.t
index c21c8a0..8437269 100644
--- a/doc/user/smp.t
+++ b/doc/user/smp.t
@@ -307,16 +307,16 @@ The Classic API provides three directives to support per task variables. These a
 @item @code{@value{DIRPREFIX}task_variable_delete} - Remove per task variable
 @end itemize
 
-As task variables are unsafe for use on SMP systems, the use of these
-services should be eliminated in all software that is to be used in
-an SMP environment. It is recommended that the application developer
-consider the use of POSIX Keys or Thread Local Storage (TLS). POSIX Keys
-are not enabled in all RTEMS configurations.
-
- at b{STATUS}: As of March 2014, some support services in the
- at code{rtems/cpukit} use per task variables. When these uses are
-eliminated, the per task variable directives will be disabled when
-building RTEMS in SMP configuration.
+As task variables are unsafe for use on SMP systems, the use of these services
+must be eliminated in all software that is to be used in an SMP environment.
+The task variables API is disabled on SMP. Its use will lead to compile-time
+and link-time errors. It is recommended that the application developer consider
+the use of POSIX Keys or Thread Local Storage (TLS). POSIX Keys are available
+in all RTEMS configurations.  For the availablity of TLS on a particular
+architecture please consult the @cite{RTEMS CPU Architecture Supplement}.
+
+The only remaining user of task variables in the RTEMS code base is the Ada
+support.  So basically Ada is not available on RTEMS SMP.
 
 @c
 @c




More information about the vc mailing list