DbEnv::set_tx_timestamp

APIRef

#include <db_cxx.h>

int DbEnv::set_tx_timestamp(time_t *timestamp);

Description

Recover to the time specified by timestamp rather than to the most current possible date. The timestamp argument should be the number of seconds since 0 hours, 0 minutes, 0 seconds, January 1, 1970, Coordinated Universal Time, i.e., the Epoch.

Once a database environment has been upgraded to a new version of Berkeley DB involving a log format change (see Upgrading Berkeley DB installations, it is no longer possible to recover to a specific time before that upgrade.

The DbEnv::set_tx_timestamp interface may only be used to configure Berkeley DB before the DbEnv::open interface is called.

The DbEnv::set_tx_timestamp method either returns a non-zero error value or throws an exception that encapsulates a non-zero error value on failure, and returns 0 on success.

Errors

EINVAL
An invalid flag value or parameter was specified.

It is not possible to recover to the specified time using the log files currently present in the environment.

Classes

DbEnv, DbTxn

See Also

DbEnv::set_tx_max, DbEnv::set_tx_recover, DbEnv::set_tx_timestamp, DbTxn::abort, DbEnv::txn_begin, DbEnv::txn_checkpoint, DbTxn::commit, DbTxn::id, DbTxn::prepare and DbEnv::txn_stat.

APIRef

Copyright Sleepycat Software