DbTxn::discard
DbTxn::discard |
|
#include <db_cxx.h>int DbTxn::discard(u_int32_t flags);
The DbTxn::discard method frees up all the per-process resources associated with the specified DbTxn handle, neither committing nor aborting the transaction. This call may be used only after calls to DbEnv::txn_recover when there are multiple global transaction managers recovering transactions in a single Berkeley DB environment. Any transactions returned by DbEnv::txn_recover that are not handled by the current global transaction manager should be discarded using DbTxn::discard.
The flags parameter is currently unused, and must be set to 0.
The DbTxn::discard method returns EINVAL if the transaction handle does not refer to a transaction that was recovered into a prepared but not yet completed state.
Otherwise, the DbTxn::discard 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.
After DbTxn::discard has been called, regardless of its return, the DbTxn handle may not be accessed again.
The DbTxn::discard method may fail and throw an exception or return a non-zero error for the following conditions:
The transaction handle does not refer to a transaction that was recovered into a prepared but not yet completed state.
The DbTxn::discard 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 DbTxn::discard 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
a69 1
DbTxn::set_timeout
d74 1
a74 1
@
1.1.1.3
log
@Import: RPM 4.0.5
@
text
@d1 2
a2 2
a3 1
d39 2
a40 2
yet completed state.
Otherwise, the DbTxn::discard method either returns a non-zero error value or throws an exception that
d52 4
a55 4
If a catastrophic error has occurred, the DbTxn::discard 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.
d57 1
a57 1
DbEnv, DbTxn
d59 14
a72 1
Transaction Subsystem and Related Methods
@
1.1.1.4
log
@Import: RPM 4.1
@
text
@d1 2
a2 2
d4 1
d40 2
a41 2
yet completed state.
Otherwise, the DbTxn::discard method either returns a non-zero error value or throws an exception that d53 4 a56 4 If a catastrophic error has occurred, the DbTxn::discard 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. d58 1 a58 1 DbEnv, DbTxn d60 1 a60 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 d39 2 a40 2 yet completed state. Otherwise, the DbTxn::discard method either returns a non-zero error value or throws an exception that d52 4 a55 4 If a catastrophic error has occurred, the DbTxn::discard 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. d57 1 a57 1 DbEnv, DbTxn d59 14 a72 1 Transaction Subsystem and Related Methods @