Whole document tree
    

Whole document tree

Berkeley DB: DBENV->set_tx_recover

DBENV->set_tx_recover

APIRef

#include <db.h>

int DBENV->set_tx_recover(DB_ENV *dbenv, int (*tx_recover)(DB_ENV *dbenv, DBT *log_rec, DB_LSN *lsn, db_recops op));

Description

Set the application's function to be called during transaction abort and recovery. This function must return 0 on success and either errno or a value outside of the Berkeley DB error name space on failure. It takes four arguments:

dbenv
A Berkeley DB environment.

log_rec
A log record.

lsn
A log sequence number.

op
One of the following values:

DB_TXN_BACKWARD_ROLL
The log is being read backward to determine which transactions have been committed and to abort those operations that were not, undo the operation described by the log record.

DB_TXN_FORWARD_ROLL
The log is being played forward, redo the operation described by the log record.

DB_TXN_ABORT
The log is being read backwards during a transaction abort, undo the operation described by the log record.

The DBENV->set_tx_recover interface may only be used to configure Berkeley DB before the DBENV->open interface is called.

The DBENV->set_tx_recover function returns a non-zero error value on failure and 0 on success.

Errors

EINVAL
An invalid flag value or parameter was specified.

Called after DBENV->open was called.

See Also

DBENV->set_tx_max, DBENV->set_tx_recover, DBENV->set_tx_timestamp, txn_abort, txn_begin, txn_checkpoint, txn_commit, txn_id, txn_prepare and txn_stat.

APIRef

Copyright Sleepycat Software