CK_EPOCH_RECLAIM(3)

💖 CK_EPOCH_RECLAIM(3) — bestie edition 💖

okay so this is the manual page for ck_epoch_reclaim(3), part of Concurrency Kit (aka libck, link it with -lck) 🎀

✨ NAME ✨

ck_epoch_reclaim — immediately execute all deferred callbacks 🫶

like, right now. no waiting. no vibes-based delay. just do them.

📚 LIBRARY 📚

Concurrency Kit (libck, -lck) 👑

🌸 SYNOPSIS 🌸

#include <ck_epoch.h>

void
ck_epoch_reclaim(ck_epoch_record_t *record);

💅 DESCRIPTION 💅

so the ck_epoch_reclaim(3) function will unconditionally execute all callbacks that have been deferred with ck_epoch_call(3) ✨

that's it. that's the whole function. she does not ask questions, she does not check the vibes, she does not wait for the grace period to be over on her own — she just runs every single deferred callback you handed her. periodt 💅

ngl bestie, "unconditionally" is doing a lot of heavy lifting in that sentence. she runs them because you said so, not because it was safe. iykyk 😭

🦋 EXAMPLE 🦋

#include <ck_epoch.h>
#include <ck_stack.h>
#include <stdlib.h>

/*
 * epoch was previously initialized with ck_epoch_init.
 */
ck_epoch_t *epoch;

void
function(void)
{
        ck_epoch_record_t *record;

        logically_delete(object);
        ck_epoch_call(epoch, record, &object->epoch_entry, destructor);

        /*
         * Wait until no threads could possibly have a reference to the
         * object we just deleted.
         */
        ck_epoch_synchronize(epoch, record);

        /*
         * Execute all deferred callbacks.
         */
        ck_epoch_reclaim(record);

        return;
}

see how she goes? logically delete the object 🌸, defer the real cleanup with ck_epoch_call(3) 🎀, synchronize so nobody could possibly still be holding a reference 😌, and then — only then — ck_epoch_reclaim(record) to actually run every deferred callback. the way that order matters… iconic. 🔥

⭐ RETURN VALUES ⭐

this function has no return value. she gives you nothing back and honestly? she doesn't have to. 🫶

🌈 SEE ALSO 🌈

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

more lore available at http://concurrencykit.org/ 🧚

Concurrency Kit, May 2, 2013 — that's the source/version and the date this page was born, and that's a wrap bestie 💜 go execute those callbacks (safely, please) 💖✨🎀