plucky (3) ck_epoch_poll.3.gz

NAME

     ck_epoch_poll — non-blocking poll of epoch object for dispatch cycles

LIBRARY

     Concurrency Kit (libck, -lck)

SYNOPSIS

     #include <ck_epoch.h>

     bool
     ck_epoch_poll(ck_epoch_record_t *record);

DESCRIPTION

     The ck_epoch_poll(3) function will attempt to dispatch any functions associated with the object pointed to
     by epoch via ck_epoch_call(3) if deemed safe. This function is meant to be used in cases epoch reclamation
     cost must be amortized over time in a manner that does not affect caller progress.

RETURN VALUES

     This functions returns false if the following conditions are met: no memory was reclaimed, the records are
     not in a grace period and no forward progress was made.

ERRORS

     Behavior is undefined if the object pointed to by record has not have been previously registered via
     ck_epoch_register(3).

SEE ALSO

     ck_epoch_init(3), ck_epoch_register(3), ck_epoch_unregister(3), ck_epoch_recycle(3),
     ck_epoch_synchronize(3), ck_epoch_reclaim(3), ck_epoch_barrier(3), ck_epoch_call(3), ck_epoch_begin(3),
     ck_epoch_end(3)

     Additional information available at http://concurrencykit.org/

                                                September 2, 2012