head 1.2; access; symbols RPM_4_2_1:1.1.1.5 RPM_4_2:1.1.1.5 RPM_4_1_1:1.1.1.5 RPM_4_1:1.1.1.4 RPM_4_0_5:1.1.1.3 RPM_4_0_4:1.1.1.2 RPM_4_0_3:1.1.1.1 RPM:1.1.1; locks; strict; comment @# @; 1.2 date 2008.01.02.09.52.56; author rse; state dead; branches; next 1.1; commitid z4cpSiAhOCXk5PLs; 1.1 date 2001.07.23.20.45.36; author rse; state Exp; branches 1.1.1.1; next ; 1.1.1.1 date 2001.07.23.20.45.36; author rse; state Exp; branches; next 1.1.1.2; 1.1.1.2 date 2002.01.08.00.30.08; author rse; state Exp; branches; next 1.1.1.3; 1.1.1.3 date 2003.01.18.13.48.57; author rse; state Exp; branches; next 1.1.1.4; 1.1.1.4 date 2001.12.06.00.07.59; author rse; state Exp; branches; next 1.1.1.5; 1.1.1.5 date 2003.01.18.14.04.56; author rse; state Exp; branches; next ; desc @@ 1.2 log @remove the ancient RPM 4.2.1 source tree copy @ text @ Berkeley DB: log_stat

log_stat

#include <db.h> int log_stat(DB_ENV *env, DB_LOG_STAT **spp); Description The log_stat function creates a statistical structure and copies a pointer to it into a user-specified memory location. Statistical structures are created 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 library function 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 log region statistics are stored in a structure of type DB_LOG_STAT. The following DB_LOG_STAT fields will be filled in: u_int32_t st_magic; The magic number that identifies a file as a log file. u_int32_t st_version; The version of the log file type. u_int32_t st_regsize; The size of the region. int st_mode; The mode of any created log files. u_int32_t st_lg_bsize; The in-memory log record cache size. u_int32_t st_lg_max; The maximum size of any individual file comprising the log. u_int32_t st_w_mbytes; The number of megabytes written to this log. u_int32_t st_w_bytes; The number of bytes over and above st_w_mbytes written to this log. u_int32_t st_wc_mbytes; The number of megabytes written to this log since the last checkpoint. u_int32_t st_wc_bytes; The number of bytes over and above st_wc_mbytes written to this log since the last checkpoint. u_int32_t st_wcount; The number of times the log has been written to disk. u_int32_t st_wcount_fill; The number of times the log has been written to disk because the in-memory log record cache filled up. u_int32_t st_scount; The number of times the log has been flushed to disk. u_int32_t st_cur_file; The current log file number. u_int32_t st_cur_offset; The byte offset in the current log file. u_int32_t st_disk_file; The log file number of the last record known to be on disk. u_int32_t st_cur_offset; The byte offset of the last record known to be on disk. u_int32_t st_region_wait; The number of times that a thread of control was forced to wait before obtaining the region lock. u_int32_t st_region_nowait; The number of times that a thread of control was able to obtain the region lock without waiting. The log_stat function returns a non-zero error value on failure and 0 on success. Errors The log_stat function 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 log_stat function may fail and return DB_RUNRECOVERY, in which case all subsequent Berkeley DB calls will fail in the same way. See Also DB_ENV->set_lg_bsize, DB_ENV->set_lg_dir, DB_ENV->set_lg_max, DB_ENV->set_lg_regionmax, log_archive, log_compare, log_file, log_flush, log_get, log_put, log_register, log_stat, and log_unregister.

Copyright Sleepycat Software @ 1.1 log @Initial revision @ text @d1 1 a1 1 @ 1.1.1.1 log @Import: RPM 4.0.3 @ text @@ 1.1.1.2 log @Import: RPM 4.0.4 @ text @d1 1 a1 1 d6 1 a6 1 Berkeley DB: DB_ENV->log_stat d14 1 a14 1

DB_ENV->log_stat

d25 1 a25 1 DB_ENV->log_stat(DB_ENV *env, DB_LOG_STAT **spp, u_int32_t flags); d28 1 a28 1

The DB_ENV->log_stat function a30 5

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

DB_STAT_CLEAR: Reset statistics after returning their values.

d43 1 a58 1

u_int32_t st_disk_offset;

The byte offset of the last record known to be on disk. a59 5

u_int32_t st_flushcommit;

The number of log flushes that contained a transaction commit record.

u_int32_t st_maxcommitperflush;

The maximum number of commits contained in a single log flush.

u_int32_t st_mincommitperflush;

The minimum number of commits contained in a single log flush that contained a commit.]

u_int32_t st_regsize;

The size of the region. d65 1 a65 1

The DB_ENV->log_stat function returns a non-zero error value on failure and 0 on success. d67 2 a68 2

The DB_ENV->log_stat function 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->log_stat function may fail and return d76 1 a76 1 DB_ENV->log_archive, d78 6 a83 8 DB_ENV->log_cursor, DB_ENV->log_file, DB_ENV->log_flush, DB_ENV->log_put, DB_ENV->log_register, DB_ENV->log_stat, DB_ENV->log_unregister, DB_LOGC->close d85 1 a85 1 DB_LOGC->get. @ 1.1.1.3 log @Import: RPM 4.0.5 @ text @d1 2 a2 2 a3 1 d28 3 a30 1

The DB_ENV->log_stat method returns the logging subsystem statistics. a35 3

The DB_ENV->log_stat method creates a statistical structure of type DB_LOG_STAT and copies a pointer to it into a user-specified memory location. d39 1 a39 1 library malloc(3) interface is used. The caller is d43 2 a44 1

The following DB_LOG_STAT fields will be filled in: d50 1 a50 1

u_int32_t st_lg_size;

The current log file size. d65 1 d75 1 a75 1

The DB_ENV->log_stat method returns a non-zero error value on failure and 0 on success. d77 4 a80 6

The DB_ENV->log_stat 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->log_stat 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_LOGC, DB_LSN d82 16 a97 1 Logging Subsystem and Related Methods @ 1.1.1.4 log @Import: RPM 4.1 @ text @d1 2 a2 2 d4 1 d29 1 a29 3

The DB_ENV->log_stat function creates a statistical structure and copies a pointer to it into a user-specified memory location. d35 3 d41 1 a41 1 library function malloc(3) is used. The caller is d45 1 a45 2

The log region statistics are stored in a structure of type DB_LOG_STAT. The following DB_LOG_STAT fields will be filled in: d51 1 a51 1

u_int32_t st_lg_max;

The maximum size of any individual file comprising the log. a65 1

u_int32_t st_flushcommit;

The number of log flushes that contained a transaction commit record. d75 1 a75 1

The DB_ENV->log_stat function returns a non-zero error value on failure and 0 on success. d77 6 a82 4

The DB_ENV->log_stat function 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->log_stat function may fail and return DB_RUNRECOVERY, in which case all subsequent Berkeley DB calls will fail in the same way. d84 1 a84 16 DB_ENV->set_lg_bsize, DB_ENV->set_lg_dir, DB_ENV->set_lg_max, DB_ENV->set_lg_regionmax, DB_ENV->log_archive, log_compare, DB_ENV->log_cursor, DB_ENV->log_file, DB_ENV->log_flush, DB_ENV->log_put, DB_ENV->log_register, DB_ENV->log_stat, DB_ENV->log_unregister, DB_LOGC->close and DB_LOGC->get. @ 1.1.1.5 log @Import: RPM 4.1.1 @ text @d1 2 a2 2 a3 1 d28 3 a30 1

The DB_ENV->log_stat method returns the logging subsystem statistics. a35 3

The following DB_LOG_STAT fields will be filled in: d50 1 a50 1

u_int32_t st_lg_size;

The current log file size. d65 1 d75 1 a75 1

The DB_ENV->log_stat method returns a non-zero error value on failure and 0 on success. d77 4 a80 6

Class

DB_ENV, DB_LOGC, DB_LSN d82 16 a97 1 Logging Subsystem and Related Methods @