Page Comparison

OS_TLS  OS_TLS_GetValue (OS_TCB    *p_tcb,

                         OS_TLS_ID  id,

                         OS_ERR    *p_err);

...

Description

Returns the current value of a task’s TLS (thread-local storage) stored in the task’s p_tcb->TLS_Tbl[id]. See Chapter 20, “Thread Safety of the Compiler’s Run-Time Library” for details on TLS.

Files

os.h/os_tls.c

Prototype

Arguments

p_tcb

is a pointer to the OS_TCB of the task you wish to retrieve the TLS from. You will get a copy of the p_tcb->TLS_Tbl[id] entry and of course, the entry will not be changed.

...

The value store in p_tcb->TLS_Tbl[id] or NULL if an error occurred.

Required Configuration

OS_CFG_TLS_TBL_SIZE must be higher than 0 in os_cfg.h. Refer to uC-OS-III Configuration Manual

Callers

Application.

Notes/Warnings

1. You cannot call OS_TLS_GetValue() for a task until that task gets created.

Example