qthread_get_tasklocal(3)

💖 qthread_get_tasklocal(3) 💖

okay so bestie, this one lives in the libqthread manual, section 3 — it's a library call, not a command, so no shell shenanigans, we're in C land now 🧚

✨ NAME ✨

qthread_get_tasklocal — get a pointer to the task-local data segment, periodt 💅

🌸 SYNOPSIS 🌸

#include <qthread/qthread.h>

void *
qthread_get_tasklocal (unsigned int size);

🦋 DESCRIPTION 🦋

so the whole vibe of this function is: you call it, and it hands you back a pointer to the data segment that belongs to your task specifically. task-specific, nobody else's, main character energy only 👑

when it works, what you get back is a pointer to a memory segment that's at least as large as size bytes. when it doesn't work? you get NULL. that's it, that's the deal 😭

and here's the cute part — if size is bigger than however much space is currently allocated, the allocation just gets bumped up to the size you asked for. it grows for you, no cap 🫶

if you wanna know how big the task-local data segment currently is, go hit up qthread_size_tasklocal() — that's literally its whole job.

⚠️ important caveat bestie: if you call this function from outside a qthread context, you get NULL. no task, no tasklocal, that's just how it is 💀

🌈 ENVIRONMENT 🌈

the behaviour of qthread_get_tasklocal() gets modified by this one environment variable:

• QTHREAD_TASKLOCAL_SIZE — this sets the task-local data segment size at initialization. and listen, changes to this value during the program run? ignored, fr fr 🙈 the value is only ever considered when qthread_init() is run. so set it early or don't bother ✨

⭐ SEE ALSO ⭐

• qthread_size_tasklocal(3)

and that's the whole page, bestie — this gem is from the libqthread manual, dated JUNE 2011. vintage but iconic, we love her 💜