#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