module ti.sysbios.rts.ti.ThreadLocalStorage

Thread-local RTS data support module

The ThreadLocalStorage module allows SYS/BIOS Tasks to maintain RTS data that is private to each Task. RTS data includes, among other things, the errno variable from the RTS library and the C++ exception stack. [ more ... ]
C synopsis target-domain sourced in ti/sysbios/rts/ti/ThreadLocalStorage.xdc
DETAILS
The ThreadLocalStorage module allows SYS/BIOS Tasks to maintain RTS data that is private to each Task. RTS data includes, among other things, the errno variable from the RTS library and the C++ exception stack.
This support is achieved by way of per-Task "TLS" data areas and a Task switch hook function that tracks the current Task's TLS data area on behalf of the RTS library code.
Currently requires use of the --multithreaded option for the CG tools compiler.
 
config ThreadLocalStorage_TItlsSectMemory  // module-wide

Memory section in which to place .TI.tls output data section

C synopsis target-domain
extern const String ThreadLocalStorage_TItlsSectMemory;
 
 
config ThreadLocalStorage_TItls_initSectMemory  // module-wide

Memory section in which to place .TI.tls_init output data section

C synopsis target-domain
extern const String ThreadLocalStorage_TItls_initSectMemory;
 
 
config ThreadLocalStorage_enableTLSSupport  // module-wide

Enable TI TLS support

C synopsis target-domain
extern const Bool ThreadLocalStorage_enableTLSSupport;
 
 
config ThreadLocalStorage_heapHandle  // module-wide

Heap to use for TLS allocation. If null, uses the default Heap

C synopsis target-domain
extern const IHeap_Handle ThreadLocalStorage_heapHandle;
 
Module-Wide Built-Ins

C synopsis target-domain
Types_ModuleId ThreadLocalStorage_Module_id();
// Get this module's unique id
 
Bool ThreadLocalStorage_Module_startupDone();
// Test if this module has completed startup
 
IHeap_Handle ThreadLocalStorage_Module_heap();
// The heap from which this module allocates memory
 
Bool ThreadLocalStorage_Module_hasMask();
// Test whether this module has a diagnostics mask
 
Bits16 ThreadLocalStorage_Module_getMask();
// Returns the diagnostics mask for this module
 
Void ThreadLocalStorage_Module_setMask(Bits16 mask);
// Set the diagnostics mask for this module
 
Configuration settings sourced in ti/sysbios/rts/ti/ThreadLocalStorage.xdc
 
config ThreadLocalStorage.TItlsSectMemory  // module-wide

Memory section in which to place .TI.tls output data section

Configuration settings
ThreadLocalStorage.TItlsSectMemory = String null;
 
C SYNOPSIS
 
config ThreadLocalStorage.TItls_initSectMemory  // module-wide

Memory section in which to place .TI.tls_init output data section

Configuration settings
ThreadLocalStorage.TItls_initSectMemory = String null;
 
C SYNOPSIS
 
config ThreadLocalStorage.enableTLSSupport  // module-wide

Enable TI TLS support

Configuration settings
ThreadLocalStorage.enableTLSSupport = Bool false;
 
C SYNOPSIS
 
config ThreadLocalStorage.heapHandle  // module-wide

Heap to use for TLS allocation. If null, uses the default Heap

Configuration settings
ThreadLocalStorage.heapHandle = IHeap.Handle null;
 
C SYNOPSIS
 
metaonly config ThreadLocalStorage.common$  // module-wide

Common module configuration parameters

Configuration settings
ThreadLocalStorage.common$ = Types.Common$ undefined;
 
DETAILS
All modules have this configuration parameter. Its name contains the '$' character to ensure it does not conflict with configuration parameters declared by the module. This allows new configuration parameters to be added in the future without any chance of breaking existing modules.
generated on Tue, 14 Feb 2017 19:59:46 GMT