#include <db.h>

int
DBENV->set_tx_timestamp(DB_ENV *dbenv, 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 function returns a non-zero error value on failure and 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.

See Also