Changeset c924e85 in rtems


Ignore:
Timestamp:
Dec 24, 2015, 11:03:51 PM (4 years ago)
Author:
Joel Sherrill <joel.sherrill@…>
Branches:
master
Children:
127e08bb
Parents:
2268ee6
Message:

user/task.t: Add advice on transitioning use of notepads

closes #2493.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • doc/user/task.t

    r2268ee6 rc924e85  
    661661or signal, or by restarting the task with special arguments
    662662which instruct the task to delete itself.
     663
     664@subsection Transition Advice for Obsolete Directives
     665
     666@subsubsection Notepads
     667@ifset is-C
     668@findex rtems_task_get_note
     669@findex rtems_task_set_note
     670@end ifset
     671
     672Task notepads and the associated directives
     673@code{@value{DIRPREFIX}task_get_note} and
     674@code{@value{DIRPREFIX}task_set_note} were removed after the 4.11 Release
     675Series. These were never thread-safe to access and subject to conflicting
     676use of the notepad index by libraries which were designed independently.
     677
     678It is recommended that applications be modified to use services
     679which are thread safe and not subject to issues with multiple applications
     680conflicting over the key (e.g. notepad index) selection. For most
     681applications, POSIX Keys should be used. These are available in all RTEMS
     682build configurations. It is also possible that Thread Local Storage is
     683an option for some use cases.
    663684
    664685@section Directives
Note: See TracChangeset for help on using the changeset viewer.