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_recover

txn_recover

 APIRef 

#include <db.h>


int txn_recover(DB_ENV *dbenv, DB_PREPLIST preplist[],
	long count, long *retp, u_int32_t flags);

Description

The txn_recover interface returns a list of prepared but not yet resolved transactions. The txn_recover function should only be called after the environment has been recovered. Because database environment state must be preserved between recovery and the application calling txn_recover, applications must either call txn_recover using the same environment handle used when recovery is done, or the database environment must not be configured using the DB_PRIVATE flag.

On return from txn_recover, the preplist argument will be filled in with a list of transactions that must be resolved by the application (committed, aborted or discarded). The preplist argument is a structure of type DB_PREPLIST; the following DB_PREPLIST fields will be filled in:

DB_TXN *txn;
The transaction handle for the transaction.

u_int8_t gid[DB_XIDDATASIZE];
The global transaction ID for the transaction. The global transaction ID is the one specified when the transaction was prepared. The application is responsible for ensuring uniqueness among global transaction IDs.

The application must call txn_abort, txn_commit or txn_discard on each returned DB_TXN handle before starting any new operations.

The count parameter specifies the number of available entries in the passed-in preplist array. The retp parameter returns the number of entries txn_recover has filled in, in the array.

The flags value must be set to one of the following values:

DB_FIRST
Begin returning a list of prepared, but not yet resolved transactions.

DB_NEXT
Continue returning a list of prepared, but not yet resolved transactions, starting where the last call to txn_recover left off.

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

Errors

The txn_recover 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_recover 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_recover d14 1 a14 1

DB_ENV->txn_recover

d24 2 a25 3 int DB_ENV->txn_recover(DB_ENV *dbenv, DB_PREPLIST preplist[], long count, long *retp, u_int32_t flags); d28 2 a29 2

The DB_ENV->txn_recover interface returns a list of prepared but not yet resolved transactions. The DB_ENV->txn_recover function should only be d32 2 a33 2 calling DB_ENV->txn_recover, applications must either call DB_ENV->txn_recover using the same environment handle used when recovery d36 1 a36 1

On return from DB_ENV->txn_recover, the preplist argument will d48 2 a49 2

The application must call DB_TXN->abort, DB_TXN->commit or DB_TXN->discard on each returned DB_TXN handle before d53 1 a53 1 returns the number of entries DB_ENV->txn_recover has filled in, in the d59 1 a59 1 starting where the last call to DB_ENV->txn_recover left off. d61 1 a61 1

The DB_ENV->txn_recover function returns a non-zero error value on failure and 0 on success. d63 2 a64 2

The DB_ENV->txn_recover 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_recover function may fail and return d71 8 a78 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 d80 1 a80 1 DB_ENV->txn_stat. @ 1.1.1.3 log @Import: RPM 4.0.5 @ text @d1 2 a2 2 a3 1 d30 1 a30 1 yet resolved transactions. The DB_ENV->txn_recover method should only be d50 1 a50 1 DB_TXN->discard on each returned DB_TXN handle before d62 1 a62 1

The DB_ENV->txn_recover method returns a non-zero error value on failure and 0 on success. d64 4 a67 6

The DB_ENV->txn_recover 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_recover 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 d69 14 a82 1 Transaction Subsystem and Related Methods @ 1.1.1.4 log @Import: RPM 4.1 @ text @d1 2 a2 2 d4 1 d31 1 a31 1 yet resolved transactions. The DB_ENV->txn_recover function should only be d51 1 a51 1 DB_TXN->discard on each returned DB_TXN handle before d63 1 a63 1

The DB_ENV->txn_recover function returns a non-zero error value on failure and 0 on success. d65 6 a70 4

The DB_ENV->txn_recover 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_recover function may fail and return DB_RUNRECOVERY, in which case all subsequent Berkeley DB calls will fail in the same way. d72 1 a72 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 d30 1 a30 1 yet resolved transactions. The DB_ENV->txn_recover method should only be d50 1 a50 1 DB_TXN->discard on each returned DB_TXN handle before d62 1 a62 1

The DB_ENV->txn_recover method returns a non-zero error value on failure and 0 on success. d64 4 a67 6

The DB_ENV->txn_recover 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_recover 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 d69 14 a82 1 Transaction Subsystem and Related Methods @