DbEnv::set_tx_timestamp |
#include <db_cxx.h>int DbEnv::set_tx_timestamp(time_t *timestamp);
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.
It is not possible to recover to the specified time using the log files currently present in the environment.