qthread_readstate(3)

💖 qthread_readstate(3) 💖

libqthread · the lil' introspective queen of the runtime ✨

🌸 NAME 🌸

qthread_readstate — bestie, she returns status information straight from the runtime 🫶

✨ SYNOPSIS ✨

#include <qthread.h>

size_t
qthread_readstate (const enum introspective_state type);

💅 DESCRIPTION 💅

okay so picture this: this function is literally just the runtime doing a lil' vibe check on itself 🪞✨. That's it. That's the whole job. The type argument tells her which piece of gossip you wanna hear about, and she hands it over as a size_t.

The valid values of type include, and yes we're going through all of them, no skimming bestie 💀:

• STACK_SIZE — makes the function return the size of the stack, measured in bytes, that all spawned qthreads receive. every single one. same stack size, no favorites 💖
• RUNTIME_DATA_SIZE — makes the function return the size of the runtime data structure that all spawned qthreads require. the whole squad needs it, so it's giving mandatory 🎀
• BUSYNESS — makes the function return the approximate number of threads available in the run queue of the current shepherd. approximate!! don't come for her if it's off by a lil bit 🙈
• ACTIVE_SHEPHERDS — makes the function return the number of shepherds currently active and scheduling threads. this one is equivalent to calling qthread_num_shepherds(). same energy, different font ✨
• TOTAL_SHEPHERDS — makes the function return the total number of shepherds that exist, whether active or inactive. she counts the sleepers too, no one's left out 🫶
• ACTIVE_WORKERS — makes the function return the number of worker threads currently active and scheduling threads. this one is equivalent to calling qthread_num_workers() 💅
• TOTAL_WORKERS — makes the function return the total number of worker threads that exist, whether active or inactive. again, sleepers included, everyone gets counted bestie 😭
• CURRENT_WORKER — makes the function return the ID of the current worker on which the task is executing. this one is equivalent to calling qthread_worker(). it's giving main character — it's literally about you 🎀👑
• CURRENT_TEAM — makes the function return the ID of the calling task's team. this one is equivalent to calling qt_team_id(). know your team, love your team 🦋
• PARENT_TEAM — makes the function return the ID of the calling task's team's parent-team, if it had one. this one is equivalent to calling qt_team_parent_id(). if your team has no parent, welp, that's a whole different story 💀

🌈 SEE ALSO 🌈

• qthread_id(3)
• qthread_num_shepherds(3)
• qthread_retloc(3)
• qthread_stackleft(3)

no cap, that's the whole page — go forth and introspect, bestie 🧚💜

k bye, this was libqthread, APRIL 2011, slay 💅✨