+I%Berkeley DB: txn_close[P

txn_close





#include <db.h>

inttxn_close(DB_TXNMGR *txnp);





Description



JThe txn_close function detaches a process from the transaction environmentFspecified by the DB_TXNMGR structure. All mapped regions are unmappedHand any allocated resources are freed. Any uncommitted transactions areaborted.

mIn addition, if the dir argument to txn_open was NULL and_dbenv was not initialized using db_appinit,?all files created for this shared region will be removed, as ifSthe txn_unlink function were called.



AIn multi-threaded applications, only a single thread may call thetxn_close function.

The txn_closeHfunction returns the value of errno on failure, and 0 on success.



Errors

RIf a fatal error occurs in Berkeley DB, the txn_close function may fail and returnFDB_RUNRECOVERY, at which point all subsequent database calls will alsoreturn DB_RUNRECOVERY.

The txn_close)function may fail and return errnoKfor any of the errors specified for the following Berkeley DB and C library functions: abort(3), close(3), fcntl(3), fflush(3), fprintf(3),free(3), getpid(3),6lock_vec,5log_flush, memset(3), munmap(3), shmctl(3), shmdt(3), strerror(3), strlen(3),5txn_abort, unlink(3), vfprintf(3),and vsnprintf(3).



See Also

5txn_abort,8txn_begin,Btxn_checkpoint, txn_close,7txn_commit,/txn_id,6txn_open,9txn_prepare,5txn_statand:txn_unlink.
ÿÿ