DB_ENV->memp_fcreate

APIRef

#include <db.h>

int DB_ENV->memp_fcreate(DB_ENV *dbenvp, DB_MPOOLFILE **dbmfp, u_int32_t flags);

Description

The DB_ENV->memp_fcreate method creates a DB_MPOOLFILE structure that is the handle for a Berkeley DB shared memory buffer pool file. A pointer to this structure is returned in the memory to which dbmfp refers. Calling the DB_MPOOLFILE->close method will discard the returned handle.

The flags parameter is currently unused, and must be set to 0.

The DB_ENV->memp_fcreate method returns a non-zero error value on failure and 0 on success.

Errors

The DB_ENV->memp_fcreate method may fail and return a non-zero error for errors specified for other Berkeley DB and C library or system functions. If a catastrophic error has occurred, the DB_ENV->memp_fcreate method may fail and return DB_RUNRECOVERY, in which case all subsequent Berkeley DB calls will fail in the same way.

Class

DB_ENV, DB_MPOOLFILE

See Also

Memory Pools and Related Methods

APIRef

Copyright Sleepycat Software