CK_EPOCH_BEGIN(3)

✨ CK_EPOCH_BEGIN(3) ✨

okay bestie, welcome to the ck_epoch_begin page from the Concurrency Kit manual, section 3 💖 this one's a lil function that's basically the start of a glow-up arc for your epoch-protected code, and she's important, so let's get into it 🫶

🌸 NAME 🌸

ck_epoch_begin — begin an epoch-protected segment of execution 👑

📚 LIBRARY 📚

Concurrency Kit (that's libck, link it with -lck bestie, don't forget) 🎀

🦋 SYNOPSIS 🦋

#include <ck_epoch.h>

void
ck_epoch_begin(ck_epoch_record_t *record, ck_epoch_section_t *section);

💅 DESCRIPTION 💅

so the ck_epoch_begin(3) function literally marks the beginning of an epoch-protected code section ✨ it's giving opening credits. And what closes it? A call to the ck_epoch_end(3) function, periodt — those two are a duo, you don't get one without the other 🫶

now, here's the tea: recursion is allowed for epoch-protected sections, but — and this is the important part — recursive calls get associated with the ck_epoch_begin(3) that's sitting at the top of the call stack. Like, the main character is whoever's at the top, no cap 👑

and if a section is passed? then recursion on a record will cause the epoch to be refreshed on entry of every protected section. every single one. she's thorough like that 💅

🎀 RETURN VALUES 🎀

this function has no return value — nothing, nada, she's a void, she simply doesn't do receipts 💀

🙈 ERRORS 🙈

the object pointed to by epoch must have been previously initiated via ck_epoch_init(3) ⭐ and the object pointed to by record must have been previously registered via ck_epoch_register(3) 🌟

like, fr fr, do the setup first bestie. no skipping steps, that's the vibe check 😭

👑 SEE ALSO 👑

• ck_epoch_init(3)
• ck_epoch_register(3)
• ck_epoch_unregister(3)
• ck_epoch_recycle(3)
• ck_epoch_poll(3)
• ck_epoch_synchronize(3)
• ck_epoch_reclaim(3)
• ck_epoch_barrier(3)
• ck_epoch_call(3)
• ck_epoch_end(3)

and if you want even more, there's additional information available at http://concurrencykit.org/ 🌈 go be nosy, i support it 💜

that's the whole page bestie, you ate it 💖 this lil slice of the Concurrency Kit docs is dated September 2, 2012, and the manual name you'll see floating around in the header is CK_EPOCH_BEGIN(3) — mwah, iconic, no notes ✨🎀🦋