5bbb925137
Reduce or eliminate use of the term "TLS" in the Trace2 code. The term "TLS" has two popular meanings: "thread-local storage" and "transport layer security". In the Trace2 source, the term is associated with the former. There was concern on the mailing list about it refering to the latter. Update the source and documentation to eliminate the use of the "TLS" term or replace it with the phrase "thread-local storage" to reduce ambiguity. Signed-off-by: Jeff Hostetler <jeffhost@microsoft.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
108 lines
2.5 KiB
C
108 lines
2.5 KiB
C
#ifndef TR2_TLS_H
|
|
#define TR2_TLS_H
|
|
|
|
#include "strbuf.h"
|
|
|
|
/*
|
|
* Notice: the term "TLS" refers to "thread-local storage" in the
|
|
* Trace2 source files. This usage is borrowed from GCC and Windows.
|
|
* There is NO relation to "transport layer security".
|
|
*/
|
|
|
|
/*
|
|
* Arbitry limit for thread names for column alignment.
|
|
*/
|
|
#define TR2_MAX_THREAD_NAME (24)
|
|
|
|
struct tr2tls_thread_ctx {
|
|
struct strbuf thread_name;
|
|
uint64_t *array_us_start;
|
|
size_t alloc;
|
|
size_t nr_open_regions; /* plays role of "nr" in ALLOC_GROW */
|
|
int thread_id;
|
|
};
|
|
|
|
/*
|
|
* Create thread-local storage for the current thread.
|
|
*
|
|
* We assume the first thread is "main". Other threads are given
|
|
* non-zero thread-ids to help distinguish messages from concurrent
|
|
* threads.
|
|
*
|
|
* Truncate the thread name if necessary to help with column alignment
|
|
* in printf-style messages.
|
|
*
|
|
* In this and all following functions the term "self" refers to the
|
|
* current thread.
|
|
*/
|
|
struct tr2tls_thread_ctx *tr2tls_create_self(const char *thread_name,
|
|
uint64_t us_thread_start);
|
|
|
|
/*
|
|
* Get the thread-local storage pointer of the current thread.
|
|
*/
|
|
struct tr2tls_thread_ctx *tr2tls_get_self(void);
|
|
|
|
/*
|
|
* return true if the current thread is the main thread.
|
|
*/
|
|
int tr2tls_is_main_thread(void);
|
|
|
|
/*
|
|
* Free the current thread's thread-local storage.
|
|
*/
|
|
void tr2tls_unset_self(void);
|
|
|
|
/*
|
|
* Begin a new nested region and remember the start time.
|
|
*/
|
|
void tr2tls_push_self(uint64_t us_now);
|
|
|
|
/*
|
|
* End the innermost nested region.
|
|
*/
|
|
void tr2tls_pop_self(void);
|
|
|
|
/*
|
|
* Pop any extra (above the first) open regions on the current
|
|
* thread and discard. During a thread-exit, we should only
|
|
* have region[0] that was pushed in trace2_thread_start() if
|
|
* the thread exits normally.
|
|
*/
|
|
void tr2tls_pop_unwind_self(void);
|
|
|
|
/*
|
|
* Compute the elapsed time since the innermost region in the
|
|
* current thread started and the given time (usually now).
|
|
*/
|
|
uint64_t tr2tls_region_elasped_self(uint64_t us);
|
|
|
|
/*
|
|
* Compute the elapsed time since the main thread started
|
|
* and the given time (usually now). This is assumed to
|
|
* be the absolute run time of the process.
|
|
*/
|
|
uint64_t tr2tls_absolute_elapsed(uint64_t us);
|
|
|
|
/*
|
|
* Initialize thread-local storage for Trace2.
|
|
*/
|
|
void tr2tls_init(void);
|
|
|
|
/*
|
|
* Free all Trace2 thread-local storage resources.
|
|
*/
|
|
void tr2tls_release(void);
|
|
|
|
/*
|
|
* Protected increment of an integer.
|
|
*/
|
|
int tr2tls_locked_increment(int *p);
|
|
|
|
/*
|
|
* Capture the process start time and do nothing else.
|
|
*/
|
|
void tr2tls_start_process_clock(void);
|
|
|
|
#endif /* TR2_TLS_H */
|