mpool_new() -- allocate a new page for memory pool

SYNOPSIS

#include <db.h>

#include <mpool.h>

void *mpool_new(MPOOL *mp, pgno_t *pgnoaddr);

DESCRIPTION

The mpool_new() function allocates a new page for the specified pool and returns its address and its page number.

PARAMETERS

mp: Is the memory pool for which a new page is to be allocated. This must be a pointer returned by a prior call to mpool_open().
pgnoaddr: Is the location where the page number for the new page is returned.

On success, mpool_new() return the address of the requested page, and stores the page number in pgnoaddr. Otherwise, it returns NULL, and sets errno to one of the conditions specified for read(), write(), or malloc().