|
|
DB_ENV->mutex_stat |
#include <db.h>int DB_ENV->mutex_stat(DB_ENV *env, DB_MUTEX_STAT **statp, u_int32_t flags);
int DB_ENV->mutex_stat_print(DB_ENV *env, u_int32_t flags);
The DB_ENV->mutex_stat method returns the mutex subsystem statistics.
The DB_ENV->mutex_stat method creates a statistical structure of type DB_MUTEX_STAT and copies a pointer to it into a user-specified memory location.
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.
The following DB_MUTEX_STAT fields will be filled in:
The DB_ENV->mutex_stat method returns a non-zero error value on failure and 0 on success.
The DB_ENV->mutex_stat method may fail and return one of the following non-zero errors:
The DB_ENV->mutex_stat_print method displays the mutex subsystem statistical information, as described for the DB_ENV->mutex_stat method. The information is printed to a specified output channel (see the DB_ENV->set_msgfile method for more information), or passed to an application callback function (see the DB_ENV->set_msgcall method for more information).
The DB_ENV->mutex_stat_print method may not be called before the DB_ENV->open method has been called.
The DB_ENV->mutex_stat_print method returns a non-zero error value on failure and 0 on success.
Copyright (c) 1996-2005 Sleepycat Software, Inc. - All rights reserved.