DbEnv::set_tx_timestamp
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; that is, 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 be used only 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.
The DbEnv::set_tx_timestamp method may fail and throw an exception or return a non-zero error for the following conditions:
It is not possible to recover to the specified time using the log files currently present in the environment.
The DbEnv::set_tx_timestamp method may fail and throw an exception or return a non-zero error for errors specified for other Berkeley DB and C library or system methods. If a catastrophic error has occurred, the DbEnv::set_tx_timestamp method may fail and either return DB_RUNRECOVERY or throw an exception encapsulating DB_RUNRECOVERY, in which case all subsequent Berkeley DB calls will fail in the same way.
|
|
Copyright Sleepycat Software
@
1.1
log
@Initial revision
@
text
@d1 1
a1 1
@
1.1.1.1
log
@Import: RPM 4.0.3
@
text
@@
1.1.1.2
log
@Import: RPM 4.0.4
@
text
@d1 1
a1 1
d17 1
a17 1
a65 1
DbTxn::set_timeout
d70 1
a70 1
@
1.1.1.3
log
@Import: RPM 4.0.5
@
text
@d1 2
a2 2
a3 1
d36 2
a37 5
The DbEnv::set_tx_timestamp method configures operations performed using the specified DbEnv handle, not all operations performed on the underlying database environment.
The DbEnv::set_tx_timestamp interface may not be called after the DbEnv::open interface is called. d48 4 a51 4 If a catastrophic error has occurred, the DbEnv::set_tx_timestamp method may fail and either return DB_RUNRECOVERY or throw a DbRunRecoveryException, in which case all subsequent Berkeley DB calls will fail in the same way. d53 1 a53 1 DbEnv, DbTxn d55 14 a68 1 Transaction Subsystem and Related Methods @ 1.1.1.4 log @Import: RPM 4.1 @ text @d1 2 a2 2 d4 1 d37 5 a41 2
The DbEnv::set_tx_timestamp interface may be used only to configure Berkeley DB before the DbEnv::open interface is called. d52 4 a55 4 If a catastrophic error has occurred, the DbEnv::set_tx_timestamp method may fail and either return DB_RUNRECOVERY or throw an exception encapsulating DB_RUNRECOVERY, in which case all subsequent Berkeley DB calls will fail in the same way. d57 1 a57 1 DbEnv, DbTxn d59 1 a59 14 DbEnv::set_tx_max, DbEnv::set_tx_recover, DbEnv::set_tx_timestamp, DbTxn::abort, DbEnv::txn_begin, DbEnv::txn_checkpoint, DbTxn::commit, DbTxn::discard, DbTxn::id, DbTxn::prepare, DbEnv::txn_recover, DbTxn::set_timeout and DbEnv::txn_stat. @ 1.1.1.5 log @Import: RPM 4.1.1 @ text @d1 2 a2 2 a3 1 d36 2 a37 5
The DbEnv::set_tx_timestamp method configures operations performed using the specified DbEnv handle, not all operations performed on the underlying database environment.
The DbEnv::set_tx_timestamp interface may not be called after the DbEnv::open interface is called. d48 4 a51 4 If a catastrophic error has occurred, the DbEnv::set_tx_timestamp method may fail and either return DB_RUNRECOVERY or throw a DbRunRecoveryException, in which case all subsequent Berkeley DB calls will fail in the same way. d53 1 a53 1 DbEnv, DbTxn d55 14 a68 1 Transaction Subsystem and Related Methods @