Debian Codegraph @

docs/installation/upgrade_4_8_mpool.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>Minor Change in Behavior of DB_MPOOLFILE-&gt;get</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 Installation and Build Guide" />
10 <link rel="up" href="upgrade_4_8_toc.html" title="Chapter 13. Upgrading Berkeley DB 4.7 applications to Berkeley DB 4.8" />
11 <link rel="prev" href="upgrade_4_8_dpl.html" title="Registering DPL Secondary Keys" />
12 <link rel="next" href="upgrade_4_8_fcntl.html" title="Dropped Support for fcntl System Calls" />
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">Minor Change in Behavior of DB_MPOOLFILE-&gt;get</th>
22 </tr>
23 <tr>
24 <td width="20%" align="left"><a accesskey="p" href="upgrade_4_8_dpl.html">Prev</a> </td>
25 <th width="60%" align="center">Chapter 13. Upgrading Berkeley DB 4.7 applications to Berkeley DB 4.8</th>
26 <td width="20%" align="right"> <a accesskey="n" href="upgrade_4_8_fcntl.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_4_8_mpool"></a>Minor Change in Behavior of DB_MPOOLFILE-&gt;get</h2>
36 </div>
37 </div>
38 </div>
39 <p>
40 DB 4.8 introduces some performance enhancements, based on the use
41 of shared/exclusive latches instead of locks in some areas of the
42 internal buffer management code. This change will affect how the
43 <code class="classname">DB_MPOOL</code> interface handles dirty buffers.
44 </p>
45 <p> Because of these
46 changes, <code class="methodname">DB_MPOOLFILE-&gt;get</code> will now
47 acquire an exclusive latch on the buffer if
48 the <code class="literal">DB_MPOOL_DIRTY</code>
49 or <code class="literal">DB_MPOOL_EDIT</code> flags are specified. This
50 could lead to an application deadlock if the application tries to
51 fetch the buffer again, without an
52 intervening <code class="methodname">DB_MPOOLFILE-&gt;put</code> call.
53 </p>
54 <p>
55 If your application uses the <code class="literal">DB_MPOOL</code>
56 interface, and especially the <code class="literal">DB_MPOOL_DIRTY</code>
57 and <code class="literal">DB_MPOOL_EDIT</code> flags, you should review your
58 code to ensure that this behavior change does not cause your
59 application to deadlock.
60 </p>
61 </div>
62 <div class="navfooter">
63 <hr />
64 <table width="100%" summary="Navigation footer">
65 <tr>
66 <td width="40%" align="left"><a accesskey="p" href="upgrade_4_8_dpl.html">Prev</a> </td>
67 <td width="20%" align="center">
68 <a accesskey="u" href="upgrade_4_8_toc.html">Up</a>
69 </td>
70 <td width="40%" align="right"> <a accesskey="n" href="upgrade_4_8_fcntl.html">Next</a></td>
71 </tr>
72 <tr>
73 <td width="40%" align="left" valign="top">Registering DPL Secondary Keys </td>
74 <td width="20%" align="center">
75 <a accesskey="h" href="index.html">Home</a>
76 </td>
77 <td width="40%" align="right" valign="top"> Dropped Support for fcntl System Calls</td>
78 </tr>
79 </table>
80 </div>
81 </body>
82 </html>