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.00; 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.58; author rse; state Exp; branches; next 1.1.1.4; 1.1.1.4 date 2001.12.06.00.08.00; author rse; state Exp; branches; next 1.1.1.5; 1.1.1.5 date 2003.01.18.14.04.57; author rse; state Exp; branches; next ; desc @@ 1.2 log @remove the ancient RPM 4.2.1 source tree copy @ text @ Berkeley DB: txn_stat

txn_stat

 APIRef 

#include <db.h>


int
txn_stat(DB_ENV *env, DB_TXN_STAT **statp);

Description

The txn_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 transaction region statistics are stored in a structure of type DB_TXN_STAT. The following DB_TXN_STAT fields will be filled in:

DB_LSN st_last_ckp;
The LSN of the last checkpoint.
DB_LSN st_pending_ckp;
The LSN of any checkpoint that is currently in progress. If st_pending_ckp is the same as st_last_ckp there is no checkpoint in progress.
time_t st_time_ckp;
The time the last completed checkpoint finished (as the number of seconds since the Epoch, returned by the IEEE/ANSI Std 1003.1 (POSIX) time interface).
u_int32_t st_last_txnid;
The last transaction ID allocated.
u_int32_t st_maxtxns;
The maximum number of active transactions possible.
u_int32_t st_nactive;
The number of transactions that are currently active.
u_int32_t st_maxnactive;
The maximum number of active transactions at any one time.
u_int32_t st_nbegins;
The number of transactions that have begun.
u_int32_t st_naborts;
The number of transactions that have aborted.
u_int32_t st_ncommits;
The number of transactions that have committed.
u_int32_t st_regsize;
The size of the region.
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.
DB_TXN_ACTIVE * st_txnarray;
A pointer to an array of st_nactive DB_TXN_ACTIVE structures, describing the currently active transactions. The following fields of the DB_TXN_ACTIVE structure will be filled in:

u_int32_t txnid;
The transaction ID of the transaction.
u_int32_t parentid;
The transaction ID of the parent transaction (or 0, if no parent).
DB_LSN lsn;
The log sequence number of the transaction-begin record.

The txn_stat function returns a non-zero error value on failure and 0 on success.

Errors

The txn_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 txn_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_tx_max, DB_ENV->set_tx_recover, DB_ENV->set_tx_timestamp, txn_abort, txn_begin, txn_checkpoint, txn_commit, txn_discard, txn_id, txn_prepare, txn_recover, and txn_stat.

APIRef

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->txn_stat d14 1 a14 1

DB_ENV->txn_stat

d25 1 a25 1 DB_ENV->txn_stat(DB_ENV *env, DB_TXN_STAT **statp, u_int32_t flags); d28 1 a28 1

The DB_ENV->txn_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.
a53 1
u_int32_t st_nrestores;
The number of transactions that have been restored. d68 1 a68 1

The DB_ENV->txn_stat function returns a non-zero error value on failure and 0 on success. d70 2 a71 2

The DB_ENV->txn_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->txn_stat function may fail and return d78 8 a85 9 DB_TXN->abort, DB_ENV->txn_begin, DB_ENV->txn_checkpoint, DB_TXN->commit, DB_TXN->discard, DB_TXN->id, DB_TXN->prepare, DB_ENV->txn_recover, DB_TXN->set_timeout d87 1 a87 1 DB_ENV->txn_stat. @ 1.1.1.3 log @Import: RPM 4.0.5 @ text @d1 2 a2 2 a3 1 d28 3 a30 1

The DB_ENV->txn_stat method returns the transaction subsystem statistics. a35 3

The DB_ENV->txn_stat method creates a statistical structure of type DB_TXN_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_TXN_STAT fields will be filled in: d46 4 a49 1

DB_LSN st_last_ckp;
The LSN of the last checkpoint. d65 1 a65 1
DB_TXN_ACTIVE *st_txnarray;
A pointer to an array of st_nactive DB_TXN_ACTIVE structures, d71 1 a71 1
DB_LSN lsn;
The current log sequence number when the transaction was begun. d74 1 a74 1

The DB_ENV->txn_stat method returns a non-zero error value on failure and 0 on success. d76 4 a79 6

The DB_ENV->txn_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->txn_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_TXN d81 14 a94 1 Transaction 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->txn_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 transaction region statistics are stored in a structure of type DB_TXN_STAT. The following DB_TXN_STAT fields will be filled in: d47 1 a47 4

DB_LSN st_last_ckp;
The LSN of the last checkpoint.
DB_LSN st_pending_ckp;
The LSN of any checkpoint that is currently in progress. If st_pending_ckp is the same as st_last_ckp there is no checkpoint in progress. d63 1 a63 1
DB_TXN_ACTIVE * st_txnarray;
A pointer to an array of st_nactive DB_TXN_ACTIVE structures, d69 1 a69 1
DB_LSN lsn;
The log sequence number of the transaction-begin record. d72 1 a72 1

The DB_ENV->txn_stat function returns a non-zero error value on failure and 0 on success. d74 6 a79 4

The DB_ENV->txn_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->txn_stat function may fail and return DB_RUNRECOVERY, in which case all subsequent Berkeley DB calls will fail in the same way. d81 1 a81 14 DB_ENV->set_tx_max, DB_ENV->set_tx_recover, DB_ENV->set_tx_timestamp, DB_TXN->abort, DB_ENV->txn_begin, DB_ENV->txn_checkpoint, DB_TXN->commit, DB_TXN->discard, DB_TXN->id, DB_TXN->prepare, DB_ENV->txn_recover, DB_TXN->set_timeout and DB_ENV->txn_stat. @ 1.1.1.5 log @Import: RPM 4.1.1 @ text @d1 2 a2 2 a3 1 d28 3 a30 1

The DB_ENV->txn_stat method returns the transaction subsystem statistics. a35 3

The DB_ENV->txn_stat method creates a statistical structure of type DB_TXN_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_TXN_STAT fields will be filled in: d46 4 a49 1

DB_LSN st_last_ckp;
The LSN of the last checkpoint. d65 1 a65 1
DB_TXN_ACTIVE *st_txnarray;
A pointer to an array of st_nactive DB_TXN_ACTIVE structures, d71 1 a71 1
DB_LSN lsn;
The current log sequence number when the transaction was begun. d74 1 a74 1

The DB_ENV->txn_stat method returns a non-zero error value on failure and 0 on success. d76 4 a79 6

The DB_ENV->txn_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->txn_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_TXN d81 14 a94 1 Transaction Subsystem and Related Methods @