Berkeley DB: DbTxn::commit

DbTxn::commit

#include <db_cxx.h> int DbTxn::commit(); Description The DbTxn::commit method ends the transaction specified by the tid argument. If DB_TXN_NOSYNC was not specified, a commit log record is written and flushed to disk, as are all previously written log records. If the transaction is nested, its locks are acquired by the parent transaction, otherwise its locks are released. Note: nested transactions are not yet supported. Any applications that require strict two-phase locking must not release any locks explicitly, leaving them all to be released by DbTxn::commit. The DbTxn::commit method either returns errno or throws an exception that encapsulates an errno on failure, and 0 on success. Errors If a fatal error occurs in Berkeley DB, the DbTxn::commit method may fail and either return DB_RUNRECOVERY or throw an exception encapsulating DB_RUNRECOVERY, at which point all subsequent database calls will also fail in the same way. Methods marked as returning errno will, by default, throw an exception that encapsulates the error information. The default error behavior can be changed, see DbException. The DbTxn::commit method may fail and throw an exception for any of the errors specified for the following Berkeley DB and C library functions: abort(3), fcntl(3), fflush(3), fprintf(3), free(3), getpid(3), DbLockTab::vec, DbLog::put, malloc(3), memcpy(3), memset(3), strerror(3), vfprintf(3), and vsnprintf(3). In addition, the DbTxn::commit method may fail and throw an exception or return errno for the following conditions: EINVAL The transaction was already aborted. Class DbTxn See Also DbTxn::abort, DbTxn::commit, DbTxn::id and DbTxn::prepare.