Skip to content

Commit

Permalink
Fix #741, Document CFE_TBL_Unregister use-case
Browse files Browse the repository at this point in the history
  • Loading branch information
skliper committed Jun 3, 2021
1 parent 176e3df commit 8da9a42
Showing 1 changed file with 12 additions and 5 deletions.
17 changes: 12 additions & 5 deletions modules/core_api/fsw/inc/cfe_tbl.h
Original file line number Diff line number Diff line change
Expand Up @@ -230,11 +230,18 @@ CFE_Status_t CFE_TBL_Share(CFE_TBL_Handle_t *TblHandlePtr, const char *TblName);
** \brief Unregister a previously registered table and free associated resources
**
** \par Description
** When an application is being removed from the system, it should
** unregister those tables that it created. The application should
** call this function as a part of its cleanup process. The table
** will be removed from memory once all table addresses referencing
** it have been released.
** When an application is being removed from the system, ES will
** clean up/free all the application related resources including tables
** so apps are not required to call this function.
**
** Typically apps should only register tables during initialization and
** registration/unregistration during operation should be avoided.
** If those actions can not be avoided, special care needs to be taken
** (especially for shared tables) to avoid race conditions due to
** competing requests from mutiple tasks.
**
** Note the table will be removed from memory once all table access
** links have been removed (registration and all shared access).
**
** \par Assumptions, External Events, and Notes:
** None
Expand Down

0 comments on commit 8da9a42

Please sign in to comment.