qt_sinc_wait(3)

✨ qt_sinc_wait — bestie, we waitin' ✨

ok so real talk, this is page qt_sinc_wait(3) from the libqthread manual. sit down, grab a lil drink 🍓, and let's get into it.

💅 NAME 💅

qt_sinc_wait — blocks the caller until every expected submission has been submitted. yes, that's the whole job. she waits. she's patient. she's giving loyal bestie energy. 🫶

🌸 SYNOPSIS 🌸

#include <qthread/sinc.h>

void
qt_sinc_wait (qt_sinc_t *restrict sinc,
                void *restrict target);

that's it, that's the whole thing. two pointers, restrict on both, returns void — no return value, no drama, no notes. ✨

🦋 DESCRIPTION 🦋

so here's the vibe: this function blocks the calling task until the sinc you handed it has received all of the submissions it expects. like, every single one. no skipping, no cutting the line. 💀

and here's the lowkey iconic part — the number of expected submissions is allowed to increase while your thread is just sitting there blocked. which, honestly? that just makes you block longer. the clock keeps ticking, bestie. it only ever adds time, it never takes it away. 🙈

then, right at the very last second — like, juuust before the calling task gets released — if the sinc was initialized to perform a reduction operation, the result of that operation gets copied into the memory pointed at by target. 🎀

and the number of bytes copied? that was already decided. it was specified back when the sinc was initialized. so it's not a surprise, it's not improv, it's all pre-planned. main character energy, honestly. 👑

👀 SEE ALSO 👀

the whole friend group, go say hi:

• qt_sinc_create(3)
• qt_sinc_destroy(3)
• qt_sinc_expect(3)
• qt_sinc_fini(3)
• qt_sinc_init(3)
• qt_sinc_reset(3)
• qt_sinc_submit(3)

ok that's the page!! 💖 this was brought to you by libqthread, dated AUGUST 2012, and it's the qt_sinc_wait(3) era forever. periodt. 💅✨🦋🌸