summaryrefslogtreecommitdiffstats
path: root/doc/user/task.t
diff options
context:
space:
mode:
authorJoel Sherrill <joel.sherrill@oarcorp.com>2015-12-24 17:03:51 -0600
committerJoel Sherrill <joel.sherrill@oarcorp.com>2015-12-24 17:03:51 -0600
commitc924e8502f6ad340acfae0e55443d0acde45fdf1 (patch)
tree6c22dc053f43009bcfda6f625e48aa29bf01bf02 /doc/user/task.t
parentlibbsp/bfin and libbsp/powerpc acinclude.m4 regenerate (diff)
downloadrtems-c924e8502f6ad340acfae0e55443d0acde45fdf1.tar.bz2
user/task.t: Add advice on transitioning use of notepads
closes #2493.
Diffstat (limited to '')
-rw-r--r--doc/user/task.t21
1 files changed, 21 insertions, 0 deletions
diff --git a/doc/user/task.t b/doc/user/task.t
index 6d0ff54e25..c51fbf3491 100644
--- a/doc/user/task.t
+++ b/doc/user/task.t
@@ -661,6 +661,27 @@ task to delete itself by sending a "delete self" message, event,
or signal, or by restarting the task with special arguments
which instruct the task to delete itself.
+@subsection Transition Advice for Obsolete Directives
+
+@subsubsection Notepads
+@ifset is-C
+@findex rtems_task_get_note
+@findex rtems_task_set_note
+@end ifset
+
+Task notepads and the associated directives
+@code{@value{DIRPREFIX}task_get_note} and
+@code{@value{DIRPREFIX}task_set_note} were removed after the 4.11 Release
+Series. These were never thread-safe to access and subject to conflicting
+use of the notepad index by libraries which were designed independently.
+
+It is recommended that applications be modified to use services
+which are thread safe and not subject to issues with multiple applications
+conflicting over the key (e.g. notepad index) selection. For most
+applications, POSIX Keys should be used. These are available in all RTEMS
+build configurations. It is also possible that Thread Local Storage is
+an option for some use cases.
+
@section Directives
This section details the task manager's directives. A