mpool_filter()

filter memory pool data 

Function


SYNOPSIS

#include <db.h>

#include <mpool.h>

void mpool_filter(MPOOL *mp, void (*pgin)(void *, pgno_t, void *), void (*pgout)(void *, pgno_t, void *), void *pgcookie);


DESCRIPTION

The mpool_filter() function is intended to make transparent input and output processing of pages transparent. If a page-in function is specified, it is called each time a buffer is read into the memory pool from the backing file. If the page-out function is specified, it is called each time a buffer is written into the backing file. Both functions are called with the pgcookie parameter, the page number, and a pointer to the back being read or written.


PARAMETERS

mp 

Points to the memory pool whose data is to be filtered. This must be a pointer returned by a prior call to mpool_open().

pgin 

Is an optional function to be called whenever a page is read from the backing file.

pgout 

Is an optional function to be called whenever a page is written to the backing file.

pgcookie 

Is an arbitrary value passed to the page-in and page-out functions.


RETURN VALUES

Nothing


CONFORMANCE

4.4BSD.


MULTITHREAD SAFETY LEVEL

Unsafe.


PORTING ISSUES

None


AVAILABILITY

PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition


SEE ALSO

Functions:
mpool_close(), mpool_get(), mpool_new(), mpool_open(), mpool_put(), mpool_sync()


PTC MKS Toolkit 10.3 Documentation Build 39.