int DB_ENV->txn_recover(DB_ENV *dbenv, DB_PREPLIST preplist, long count, long *retp, u_int32_t flags);
The DB_ENV->txn_recover interface returns a list of prepared but not yet resolved transactions. The DB_ENV->txn_recover method should only be called after the environment has been recovered. Because database environment state must be preserved between recovery and the application calling DB_ENV->txn_recover, applications must either call DB_ENV->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 DB_ENV->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:
The application must call DB_TXN->abort, DB_TXN->commit or DB_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 DB_ENV->txn_recover has filled in, in the array.
The flags value must be set to one of the following values:
The DB_ENV->txn_recover method returns a non-zero error value on failure and 0 on success.
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.
Copyright Sleepycat Software