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.