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

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

SEE ALSO

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

MKS Toolkit 9.3 Documentation Build 6.