Struct BufferPoolThreadCache 

pub struct BufferPoolThreadCache;

Access to the calling thread’s local BufferPool caches.

This type hides the TLS layout used by pooled allocation and return. The main TLS key owns the registry. It has a destructor, so thread exit drops the registry and each TlsSizeClassCache flushes its remaining entries to the class-global freelist.

Steady-state allocation and return first read TLS_SIZE_CLASS_CACHES_FAST. If it points at this thread’s registry and the requested class cache is initialized, the caller touches only thread-local memory. Missing TLS state routes through cache_slow or push_slow, which access the owning TLS key, install the fast pointer, and lazily initialize the class cache.

Rust’s access path for TLS values with destructors includes checks for access during or after destruction. Those checks are correct, but they are expensive on the hot pooled allocation/drop path. After first checked access, we cache a raw pointer to the same registry in a destructor-free TLS key and use that pointer for steady-state access.

If the checked key is unavailable during thread-local destruction, cache access returns None and callers use the class-global freelist instead.

Implementations

impl BufferPoolThreadCache

pub fn flush()

Flushes all local caches for the current thread into the global freelists.