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.53.28; 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.09; author rse; state Exp;
branches;
next 1.1.1.3;
1.1.1.3
date 2003.01.18.13.48.59; author rse; state Exp;
branches;
next 1.1.1.4;
1.1.1.4
date 2001.12.06.00.08.06; author rse; state Exp;
branches;
next 1.1.1.5;
1.1.1.5
date 2003.01.18.14.04.58; author rse; state Exp;
branches;
next ;
desc
@@
1.2
log
@remove the ancient RPM 4.2.1 source tree copy
@
text
@
Berkeley DB: DbEnv::log_stat
DbEnv::log_stat
|
 
|
#include <db_cxx.h>
int
DbEnv::log_stat(DB_LOG_STAT **spp);
Description
The DbEnv::log_stat method
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 DbEnv::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 DbEnv::log_stat method either returns a non-zero error value or throws an exception that
encapsulates a non-zero error value on failure, and returns 0 on success.
Errors
The DbEnv::log_stat method may fail and throw an exception or return a non-zero error for errors specified for other Berkeley DB and C library or system methods.
If a catastrophic error has occurred, the DbEnv::log_stat method may fail and either
return DB_RUNRECOVERY or throw an exception encapsulating
DB_RUNRECOVERY, in which case all subsequent Berkeley DB calls will fail
in the same way.
Class
DbEnv
See Also
DbEnv::set_lg_bsize,
DbEnv::set_lg_dir,
DbEnv::set_lg_max,
DbEnv::set_lg_regionmax,
DbEnv::log_archive,
DbEnv::log_compare,
DbEnv::log_file,
DbEnv::log_flush,
DbEnv::log_get,
DbEnv::log_put,
DbEnv::log_register,
DbEnv::log_stat,
and
DbEnv::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
d17 1
a17 1
d25 1
a25 1
DbEnv::log_stat(DB_LOG_STAT **spp, u_int32_t flags);
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.
a81 1
DbEnv::log_cursor,
d84 1
a87 2
DbEnv::log_unregister,
DbLogc::logc_close
d89 1
a89 1
DbLogc::logc_get.
d92 1
a92 1
@
1.1.1.3
log
@Import: RPM 4.0.5
@
text
@d1 2
a2 2
a3 1
d28 3
a30 1
The DbEnv::log_stat method returns the logging subsystem statistics.
a35 3
The DbEnv::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
d79 4
a82 4
If a catastrophic error has occurred, the DbEnv::log_stat method may fail and
either return DB_RUNRECOVERY or throw a
DbRunRecoveryException,
in which case all subsequent Berkeley DB calls will fail in the same way.
d84 1
a84 1
DbEnv, DbLogc, DbLsn
d86 16
a101 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 DbEnv::log_stat method
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.
d79 4
a82 4
If a catastrophic error has occurred, the DbEnv::log_stat method may fail and either
return DB_RUNRECOVERY or throw an exception encapsulating
DB_RUNRECOVERY, in which case all subsequent Berkeley DB calls will fail
in the same way.
d84 1
a84 1
DbEnv
d86 1
a86 16
DbEnv::set_lg_bsize,
DbEnv::set_lg_dir,
DbEnv::set_lg_max,
DbEnv::set_lg_regionmax,
DbEnv::log_archive,
DbEnv::log_compare,
DbEnv::log_cursor,
DbEnv::log_file,
DbEnv::log_flush,
DbEnv::log_put,
DbEnv::log_register,
DbEnv::log_stat,
DbEnv::log_unregister,
DbLogc::logc_close
and
DbLogc::logc_get.
@
1.1.1.5
log
@Import: RPM 4.1.1
@
text
@d1 2
a2 2
a3 1
d28 3
a30 1
The DbEnv::log_stat method returns the logging subsystem statistics.
a35 3
The DbEnv::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
d79 4
a82 4
If a catastrophic error has occurred, the DbEnv::log_stat method may fail and
either return DB_RUNRECOVERY or throw a
DbRunRecoveryException,
in which case all subsequent Berkeley DB calls will fail in the same way.
d84 1
a84 1
DbEnv, DbLogc, DbLsn
d86 16
a101 1
Logging Subsystem and Related Methods
@