Debian Codegraph @

docs/upgrading/upgrade_3_0_close.html

raw
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>DB-&gt;sync and DB-&gt;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 Upgrade Guide" />
10 <link rel="up" href="upgrade_3_0_toc.html" title="Chapter 14. Upgrading Berkeley DB 2.X applications to Berkeley DB 3.0" />
11 <link rel="prev" href="upgrade_3_0_stat.html" title="DB-&gt;stat" />
12 <link rel="next" href="upgrade_3_0_lock_put.html" title="lock_put" />
13 </head>
14 <body>
15 <div xmlns="" class="navheader">
16 <div class="libver">
17 <p>Library Version 11.2.5.3</p>
18 </div>
19 <table width="100%" summary="Navigation header">
20 <tr>
21 <th colspan="3" align="center">DB-&gt;sync and DB-&gt;close</th>
22 </tr>
23 <tr>
24 <td width="20%" align="left"><a accesskey="p" href="upgrade_3_0_stat.html">Prev</a> </td>
25 <th width="60%" align="center">Chapter 14. Upgrading Berkeley DB 2.X applications to Berkeley DB 3.0</th>
26 <td width="20%" align="right"> <a accesskey="n" href="upgrade_3_0_lock_put.html">Next</a></td>
27 </tr>
28 </table>
29 <hr />
30 </div>
31 <div class="sect1" lang="en" xml:lang="en">
32 <div class="titlepage">
33 <div>
34 <div>
35 <h2 class="title" style="clear: both"><a id="upgrade_3_0_close"></a>DB-&gt;sync and DB-&gt;close</h2>
36 </div>
37 </div>
38 </div>
39 <p>In previous Berkeley DB releases, the <a href="../api_reference/C/dbclose.html" class="olink">DB-&gt;close()</a> and <a href="../api_reference/C/dbsync.html" class="olink">DB-&gt;sync()</a> methods
40 discarded any return of DB_INCOMPLETE from the underlying buffer
41 pool interfaces, and returned success to its caller. (The
42 DB_INCOMPLETE error will be returned if the buffer pool functions
43 are unable to flush all of the database's dirty blocks from the pool.
44 This often happens if another thread is reading or writing the database's
45 pages in the pool.)</p>
46 <p>In the 3.X release, <a href="../api_reference/C/dbsync.html" class="olink">DB-&gt;sync()</a> and <a href="../api_reference/C/dbclose.html" class="olink">DB-&gt;close()</a> will return
47 DB_INCOMPLETE to the application. The best solution is to not
48 call <a href="../api_reference/C/dbsync.html" class="olink">DB-&gt;sync()</a> with the <a href="../api_reference/C/dbclose.html#dbclose_DB_NOSYNC" class="olink">DB_NOSYNC</a> flag to the
49 <a href="../api_reference/C/dbclose.html" class="olink">DB-&gt;close()</a> method when multiple threads are expected to be accessing the
50 database. Alternatively, the caller can ignore any error return of
51 DB_INCOMPLETE.</p>
52 </div>
53 <div class="navfooter">
54 <hr />
55 <table width="100%" summary="Navigation footer">
56 <tr>
57 <td width="40%" align="left"><a accesskey="p" href="upgrade_3_0_stat.html">Prev</a> </td>
58 <td width="20%" align="center">
59 <a accesskey="u" href="upgrade_3_0_toc.html">Up</a>
60 </td>
61 <td width="40%" align="right"> <a accesskey="n" href="upgrade_3_0_lock_put.html">Next</a></td>
62 </tr>
63 <tr>
64 <td width="40%" align="left" valign="top">DB-&gt;stat </td>
65 <td width="20%" align="center">
66 <a accesskey="h" href="index.html">Home</a>
67 </td>
68 <td width="40%" align="right" valign="top"> lock_put</td>
69 </tr>
70 </table>
71 </div>
72 </body>
73 </html>