1<!--$Id: close.so,v 11.10 2002/03/06 15:51:57 bostic Exp $--> 2<!--Copyright (c) 1997,2008 Oracle. All rights reserved.--> 3<!--See the file LICENSE for redistribution information.--> 4<html> 5<head> 6<title>Berkeley DB Reference Guide: Release 3.0: DB->sync and DB->close</title> 7<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> 8<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> 9</head> 10<body bgcolor=white> 11<table width="100%"><tr valign=top> 12<td><b><dl><dt>Berkeley DB Reference Guide:<dd>Upgrading Berkeley DB Applications</dl></b></td> 13<td align=right><a href="../upgrade.3.0/stat.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../toc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../upgrade.3.0/lock_put.html"><img src="../../images/next.gif" alt="Next"></a> 14</td></tr></table> 15<p align=center><b>Release 3.0: DB->sync and DB->close</b></p> 16<p>In previous Berkeley DB releases, the <a href="../../api_c/db_close.html">DB->close</a> and <a href="../../api_c/db_sync.html">DB->sync</a> methods 17discarded any return of DB_INCOMPLETE from the underlying buffer 18pool interfaces, and returned success to its caller. (The 19DB_INCOMPLETE error will be returned if the buffer pool functions 20are unable to flush all of the database's dirty blocks from the pool. 21This often happens if another thread is reading or writing the database's 22pages in the pool.)</p> 23<p>In the 3.X release, <a href="../../api_c/db_sync.html">DB->sync</a> and <a href="../../api_c/db_close.html">DB->close</a> will return 24DB_INCOMPLETE to the application. The best solution is to not 25call <a href="../../api_c/db_sync.html">DB->sync</a> and specify the <a href="../../api_c/db_close.html#DB_NOSYNC">DB_NOSYNC</a> flag to the 26<a href="../../api_c/db_close.html">DB->close</a> method when multiple threads are expected to be accessing the 27database. Alternatively, the caller can ignore any error return of 28DB_INCOMPLETE.</p> 29<table width="100%"><tr><td><br></td><td align=right><a href="../upgrade.3.0/stat.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../toc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../upgrade.3.0/lock_put.html"><img src="../../images/next.gif" alt="Next"></a> 30</td></tr></table> 31<p><font size=1>Copyright (c) 1996,2008 Oracle. All rights reserved.</font> 32</body> 33</html> 34
