Changeset cf404563 in rtems


Ignore:
Timestamp:
Mar 10, 2015, 7:28:19 PM (5 years ago)
Author:
Gedare Bloom <gedare@…>
Branches:
4.11, master
Children:
d84995d2
Parents:
23e43f6
git-author:
Gedare Bloom <gedare@…> (03/10/15 19:28:19)
git-committer:
Gedare Bloom <gedare@…> (03/10/15 19:46:59)
Message:

cpukit: deprecate task variables. closes #2293.

Files:
4 edited

Legend:

Unmodified
Added
Removed
  • cpukit/rtems/include/rtems/rtems/tasks.h

    r23e43f6 rcf404563  
    463463 *  @brief RTEMS Add Task Variable
    464464 *
     465 *  @deprecated Task variables are deprecated.
     466 *
    465467 *  This directive adds a per task variable.
    466468 *
     
    471473  void    **ptr,
    472474  void    (*dtor)(void *)
    473 );
     475) RTEMS_COMPILER_DEPRECATED_ATTRIBUTE;
    474476
    475477/**
    476478 *  @brief Get a per-task variable
     479 *
     480 *  @deprecated Task variables are deprecated.
    477481 *
    478482 *  This directive gets the value of a task variable.
     
    484488  void **ptr,
    485489  void **result
    486 );
     490) RTEMS_COMPILER_DEPRECATED_ATTRIBUTE;
    487491
    488492/**
    489493 *  @brief RTEMS Delete Task Variable
     494 *
     495 *  @deprecated Task variables are deprecated.
    490496 *
    491497 *  This directive removes a per task variable.
     
    496502  rtems_id  tid,
    497503  void    **ptr
    498 );
     504) RTEMS_COMPILER_DEPRECATED_ATTRIBUTE;
    499505#endif
    500506
  • cpukit/rtems/include/rtems/rtems/tasksimpl.h

    r23e43f6 rcf404563  
    7171 *  @brief RTEMS Tasks Invoke Task Variable Destructor
    7272 *
     73 *  @deprecated Task variables are deprecated.
     74 *
    7375 *  This routine invokes the optional user provided destructor on the
    7476 *  task variable and frees the memory for the task variable.
     
    7779  Thread_Control        *the_thread,
    7880  rtems_task_variable_t *tvp
    79 );
     81) RTEMS_COMPILER_DEPRECATED_ATTRIBUTE;
    8082#endif
    8183
  • cpukit/sapi/include/confdefs.h

    r23e43f6 rcf404563  
    18241824 * This macro calculates the memory required for task variables.
    18251825 *
     1826 * @deprecated Task variables are deprecated.
     1827 *
    18261828 * Each task variable is individually allocated from the Workspace.
    18271829 * Hence, we do the multiplication on the configured size.
     
    18401842    #define CONFIGURE_MEMORY_FOR_TASK_VARIABLES(_task_variables) 0
    18411843  #else
     1844    #warning "Per-Task Variables are deprecated and will be removed."
    18421845    #define CONFIGURE_MEMORY_FOR_TASK_VARIABLES(_task_variables) \
    18431846      (_task_variables) * \
  • doc/user/task.t

    r23e43f6 rcf404563  
    309309@cindex per task variables
    310310
     311Per task variables are deprecated, see the warning below.
     312
    311313Per task variables are used to support global variables whose value
    312314may be unique to a task. After indicating that a variable should be
     
    347349correct value for each task executing on each core. Consequently,
    348350per-task variables are disabled in SMP configurations of RTEMS.
     351Instead the application developer should
     352consider the use of POSIX Keys or Thread Local Storage (TLS). POSIX Keys
     353are not enabled in all RTEMS configurations.
    349354
    350355@subsection Building a Task Attribute Set
     
    17881793@subheading NOTES:
    17891794
     1795This directive is deprecated and task variables will be removed.
     1796
    17901797Task variables increase the context switch time to and from the
    17911798tasks that own them so it is desirable to minimize the number of
     
    18451852@subheading NOTES:
    18461853
     1854This directive is deprecated and task variables will be removed.
     1855
    18471856If you change memory which @code{task_variable_value} points to,
    18481857remember to declare that memory as volatile, so that the compiler
     
    18961905@subheading NOTES:
    18971906
     1907This directive is deprecated and task variables will be removed.
     1908
    18981909Per-task variables are disabled in SMP configurations and this service
    18991910is not available.
Note: See TracChangeset for help on using the changeset viewer.