0I/Berkeley DB: DbTxnMgr.checkpoint[P

DbTxnMgr.checkpoint





import com.sleepycat.db.*;

int*public void checkpoint(int kbyte, int min) throws DbException;





Description



BThe DbTxnMgr.checkpoint method flushes the underlying memory pool,?writes a checkpoint record to the log and then flushes the log.

HIf either kbyte or min is non-zero, the checkpoint is onlyKdone if more than min minutes have passed since the last checkpoint,Jor if more than kbyte kilobytes of log data have been written sincethe last checkpoint.

The DbTxnMgr.checkpointHmethod throws an exception that encapsulates an errno on failure,+ and DB_INCOMPLETE if there were pages thatmneeded to be written but that DbMpool.sync was unable to write immediately.=In this case, the DbTxnMgr.checkpoint call should be retried.

‰The DbTxnMgr.checkpoint method is the underlying method used by the db_checkpoint utility.„See the db_checkpoint utility source code for an example of using DbTxnMgr.checkpointin a POSIX 1003.1 environment.



Errors

[If a fatal error occurs in Berkeley DB, the DbTxnMgr.checkpoint method may fail and throw a}DbRunRecoveryException, at which point all subsequent database%calls will also fail in the same way.

The DbTxnMgr.checkpoint&method may fail and throw an exceptionKfor 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),>DbLog.compare,6DbLog.put, malloc(3), memcpy(3),<DbMpool.sync, memset(3), strerror(3),time(3), vfprintf(3),and vsnprintf(3).

$In addition, the DbTxnMgr.checkpoint&method may fail and throw an exceptionencapsulating errnofor the following conditions:

B

EINVAL
An invalid flag value or parameter was specified.







Class

9DbTxnMgr



See Also

@DbTxnMgr.begin,DbTxnMgr.checkpoint,@DbTxnMgr.close,>DbTxnMgr.open,=DbTxnMgr.statandBDbTxnMgr.unlink.
ÿÿ