1<?xml version="1.0" encoding="UTF-8" standalone="no"?> 2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 3<html xmlns="http://www.w3.org/1999/xhtml"> 4 <head> 5 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> 6 <title>Release 3.0: DB->sync and DB->close</title> 7 <link rel="stylesheet" href="gettingStarted.css" type="text/css" /> 8 <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /> 9 <link rel="start" href="index.html" title="Berkeley DB Programmer's Reference Guide" /> 10 <link rel="up" href="upgrade_3_0_toc.html" title="Chapter��33.��Upgrading Berkeley DB 2.X applications to Berkeley DB 3.0" /> 11 <link rel="prev" href="upgrade_3_0_stat.html" title="Release 3.0: DB->stat" /> 12 <link rel="next" href="upgrade_3_0_lock_put.html" title="Release 3.0: lock_put" /> 13 </head> 14 <body> 15 <div class="navheader"> 16 <table width="100%" summary="Navigation header"> 17 <tr> 18 <th colspan="3" align="center">Release 3.0: DB->sync and DB->close</th> 19 </tr> 20 <tr> 21 <td width="20%" align="left"><a accesskey="p" href="upgrade_3_0_stat.html">Prev</a>��</td> 22 <th width="60%" align="center">Chapter��33.��Upgrading Berkeley DB 2.X applications to Berkeley DB 3.0</th> 23 <td width="20%" align="right">��<a accesskey="n" href="upgrade_3_0_lock_put.html">Next</a></td> 24 </tr> 25 </table> 26 <hr /> 27 </div> 28 <div class="sect1" lang="en" xml:lang="en"> 29 <div class="titlepage"> 30 <div> 31 <div> 32 <h2 class="title" style="clear: both"><a id="upgrade_3_0_close"></a>Release 3.0: DB->sync and DB->close</h2> 33 </div> 34 </div> 35 </div> 36 <p>In previous Berkeley DB releases, the <a href="../api_reference/C/dbclose.html" class="olink">DB->close()</a> and <a href="../api_reference/C/dbsync.html" class="olink">DB->sync()</a> methods 37discarded any return of DB_INCOMPLETE from the underlying buffer 38pool interfaces, and returned success to its caller. (The 39DB_INCOMPLETE error will be returned if the buffer pool functions 40are unable to flush all of the database's dirty blocks from the pool. 41This often happens if another thread is reading or writing the database's 42pages in the pool.)</p> 43 <p>In the 3.X release, <a href="../api_reference/C/dbsync.html" class="olink">DB->sync()</a> and <a href="../api_reference/C/dbclose.html" class="olink">DB->close()</a> will return 44DB_INCOMPLETE to the application. The best solution is to not 45call <a href="../api_reference/C/dbsync.html" class="olink">DB->sync()</a> with the <a href="../api_reference/C/dbclose.html#dbclose_DB_NOSYNC" class="olink">DB_NOSYNC</a> flag to the 46<a href="../api_reference/C/dbclose.html" class="olink">DB->close()</a> method when multiple threads are expected to be accessing the 47database. Alternatively, the caller can ignore any error return of 48DB_INCOMPLETE.</p> 49 </div> 50 <div class="navfooter"> 51 <hr /> 52 <table width="100%" summary="Navigation footer"> 53 <tr> 54 <td width="40%" align="left"><a accesskey="p" href="upgrade_3_0_stat.html">Prev</a>��</td> 55 <td width="20%" align="center"> 56 <a accesskey="u" href="upgrade_3_0_toc.html">Up</a> 57 </td> 58 <td width="40%" align="right">��<a accesskey="n" href="upgrade_3_0_lock_put.html">Next</a></td> 59 </tr> 60 <tr> 61 <td width="40%" align="left" valign="top">Release 3.0: DB->stat��</td> 62 <td width="20%" align="center"> 63 <a accesskey="h" href="index.html">Home</a> 64 </td> 65 <td width="40%" align="right" valign="top">��Release 3.0: lock_put</td> 66 </tr> 67 </table> 68 </div> 69 </body> 70</html> 71