---
name: "ck_epoch_poll"
section: "3"
platform: "linux"
package: "libck-dev"
version: "0.7.2-6"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/ck_epoch_poll"
---

# ck\_epoch\_poll(3)

non-blocking poll of epoch object for dispatch cycles

## 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_init/3.md), [ck\_epoch\_register(3)](/ck_epoch_register/3.md), [ck\_epoch\_unregister(3)](/ck_epoch_unregister/3.md), [ck\_epoch\_recycle(3)](/ck_epoch_recycle/3.md), [ck\_epoch\_synchronize(3)](/ck_epoch_synchronize/3.md), [ck\_epoch\_reclaim(3)](/ck_epoch_reclaim/3.md), [ck\_epoch\_barrier(3)](/ck_epoch_barrier/3.md), [ck\_epoch\_call(3)](/ck_epoch_call/3.md), [ck\_epoch\_begin(3)](/ck_epoch_begin/3.md), [ck\_epoch\_end(3)](/ck_epoch_end/3.md)

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