Name
ec_cache_purge — Explicitly remove elements from the cache
Synopsis
#include "ec_cache.h"
| int **ec_cache_purge** (
| cache, | |
| | now, | |
| | purge_all)
; | |
ec_cache_t * <var class="pdparam">cache</var>
;
time_t * <var class="pdparam">now</var>
;
int <var class="pdparam">purge_all</var>
;
Description
Allows you to explicitly remove elements from the cache. If the the cache was configured with a time-to-live for the elements, then the now
will be interpreted as the effective current time and elements older than now
-ttl
will be purged from the cache. If the purge_all
is non-zero, then all elements will be purged from the cache.
- cache
-
The address of the cache. The following typedef applies to the
ec_cache_t
data type:typedef struct ec_cache_head ec_cache_t;
- now
-
Will be interpreted as the effective current time.
- purge_all
-
If this parameter is non-zero, then all elements will be purged from the cache.
This function returns the number of purged entries.
While it is legal to call this function in any thread, it should only be called in the Scheduler thread.