DB_ENV->memp_stat()

#include <db.h>

int
DB_ENV->memp_stat(DB_ENV *env, DB_MPOOL_STAT **gsp,
    DB_MPOOL_FSTAT *(*fsp)[], u_int32_t flags);  

The DB_ENV->memp_stat() method returns the memory pool (that is, the buffer cache) subsystem statistics.

The DB_ENV->memp_stat() method creates statistical structures of type DB_MPOOL_STAT and DB_MPOOL_FSTAT, and copy pointers to them into user-specified memory locations. The cache statistics are stored in the DB_MPOOL_STAT structure and the per-file cache statistics are stored the DB_MPOOL_FSTAT structure.

Statistical structures are stored in allocated memory. If application-specific allocation routines have been declared (see DB_ENV->set_alloc() for more information), they are used to allocate the memory; otherwise, the standard C library malloc(3) is used. The caller is responsible for deallocating the memory. To deallocate the memory, free the memory reference; references inside the returned memory need not be individually freed.

If gsp is non-NULL, the global statistics for the cache mp are copied into the memory location to which it refers. The following DB_MPOOL_STAT fields will be filled in:

If fsp is non-NULL, a pointer to a NULL-terminated variable length array of statistics for individual files, in the cache mp, is copied into the memory location to which it refers. If no individual files currently exist in the cache, fsp will be set to NULL.

The per-file statistics are stored in structures of type DB_MPOOL_FSTAT. The following DB_MPOOL_FSTAT fields will be filled in for each file in the cache; that is, each element of the array:

The DB_ENV->memp_stat() method may not be called before the DB_ENV->open() method is called.

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

Parameters

gsp

The gsp parameter references memory into which a pointer to the allocated global statistics structure is copied.

fsp

The fsp parameter references memory into which a pointer to the allocated per-file statistics structures is copied.

flags

The flags parameter must be set to 0 or the following value:

  • DB_STAT_CLEAR

    Reset statistics after returning their values.

Errors

The DB_ENV->memp_stat() method may fail and return one of the following non-zero errors:

EINVAL

An invalid flag value or parameter was specified.

Class

DB_ENV, DB_MPOOLFILE

See Also

Memory Pools and Related Methods