API Reference Manual  1.45.0
odp_pool_stats_t Struct Reference

Pool statistics counters. More...

#include <pool_types.h>

Data Fields

uint64_t available
 The number of available events in the pool.
 
uint64_t alloc_ops
 The number of alloc operations from the pool. More...
 
uint64_t alloc_fails
 The number of failed alloc operations (pool empty)
 
uint64_t free_ops
 The number of free operations to the pool.
 
uint64_t total_ops
 The total number of alloc and free operations. More...
 
uint64_t cache_available
 The number of available events in the local caches of all threads. More...
 
uint64_t cache_alloc_ops
 The number of successful alloc operations from pool caches (returned at least one event).
 
uint64_t cache_free_ops
 The number of free operations, which stored events to pool caches.
 
struct {
   uint16_t   first
 First thread identifier to read counters from. More...
 
   uint16_t   last
 Last thread identifier to read counters from. More...
 
   uint64_t   cache_available [ODP_POOL_MAX_THREAD_STATS]
 The number of available events in each thread local cache. More...
 
thread
 Per thread counters.
 

Detailed Description

Pool statistics counters.

In addition to API alloc and free calls, statistics counters may be updated by alloc/free operations from implementation internal software or hardware components.

Examples
odp_pool_perf.c.

Definition at line 101 of file api/spec/pool_types.h.

Field Documentation

◆ alloc_ops

uint64_t odp_pool_stats_t::alloc_ops

The number of alloc operations from the pool.

Includes both successful and failed operations (pool empty).

Examples
odp_pool_perf.c.

Definition at line 107 of file api/spec/pool_types.h.

◆ total_ops

uint64_t odp_pool_stats_t::total_ops

The total number of alloc and free operations.

Includes both successful and failed operations (pool empty).

Examples
odp_pool_perf.c.

Definition at line 117 of file api/spec/pool_types.h.

◆ cache_available

uint64_t odp_pool_stats_t::cache_available[ODP_POOL_MAX_THREAD_STATS]

The number of available events in the local caches of all threads.

The number of available events in each thread local cache.

If 'first' and 'last' include all threads of the instance, the sum of 'thread.cache_available' matches 'cache_available'.

Examples
odp_pool_perf.c.

Definition at line 120 of file api/spec/pool_types.h.

◆ first

uint16_t odp_pool_stats_t::first

First thread identifier to read counters from.

Ignored when 'thread.cache_available' is not enabled.

Examples
odp_pool_perf.c.

Definition at line 133 of file api/spec/pool_types.h.

◆ last

uint16_t odp_pool_stats_t::last

Last thread identifier to read counters from.

Ignored when 'thread.cache_available' is not enabled.

Examples
odp_pool_perf.c.

Definition at line 137 of file api/spec/pool_types.h.


The documentation for this struct was generated from the following file: