docs/upgrading/upgrade_4_0_lock.html

   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>lock_XXX</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_4_0_toc.html" title="Chapter 10. Upgrading Berkeley DB 3.3 applications to Berkeley DB 4.0" />
  11     <link rel="prev" href="upgrade_4_0_deadlock.html" title="db_deadlock" />
  12     <link rel="next" href="upgrade_4_0_log.html" title="log_XXX" />
  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">lock_XXX</th>
  22         </tr>
  23         <tr>
  24           <td width="20%" align="left"><a accesskey="p" href="upgrade_4_0_deadlock.html">Prev</a> </td>
  25           <th width="60%" align="center">Chapter 10. Upgrading Berkeley DB 3.3 applications to Berkeley DB 4.0</th>
  26           <td width="20%" align="right"> <a accesskey="n" href="upgrade_4_0_log.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_0_lock"></a>lock_XXX</h2>
  36           </div>
  37         </div>
  38       </div>
  39       <p>The C API for the Berkeley DB Locking subsystem was reworked in the 4.0
  40 release as follows:</p>
  41       <div class="informaltable">
  42         <table border="1" width="80%">
  43           <colgroup>
  44             <col />
  45             <col />
  46           </colgroup>
  47           <thead>
  48             <tr>
  49               <th>Historic functional interface</th>
  50               <th>Berkeley DB 4.X method</th>
  51             </tr>
  52           </thead>
  53           <tbody>
  54             <tr>
  55               <td>lock_detect</td>
  56               <td>
  57                 <a href="../api_reference/C/lockdetect.html" class="olink">DB_ENV-&gt;lock_detect()</a>
  58               </td>
  59             </tr>
  60             <tr>
  61               <td>lock_get</td>
  62               <td>
  63                 <a href="../api_reference/C/lockget.html" class="olink">DB_ENV-&gt;lock_get()</a>
  64               </td>
  65             </tr>
  66             <tr>
  67               <td>lock_id</td>
  68               <td>
  69                 <a href="../api_reference/C/lockid.html" class="olink">DB_ENV-&gt;lock_id()</a>
  70               </td>
  71             </tr>
  72             <tr>
  73               <td>lock_put</td>
  74               <td>
  75                 <a href="../api_reference/C/lockput.html" class="olink">DB_ENV-&gt;lock_put()</a>
  76               </td>
  77             </tr>
  78             <tr>
  79               <td>lock_stat</td>
  80               <td>
  81                 <a href="../api_reference/C/lockstat.html" class="olink">DB_ENV-&gt;lock_stat()</a>
  82               </td>
  83             </tr>
  84             <tr>
  85               <td>lock_vec</td>
  86               <td>
  87                 <a href="../api_reference/C/lockvec.html" class="olink">DB_ENV-&gt;lock_vec()</a>
  88               </td>
  89             </tr>
  90           </tbody>
  91         </table>
  92       </div>
  93       <p>Applications calling any of these functions should update their calls
  94 to use the enclosing <a href="../api_reference/C/env.html" class="olink">DB_ENV</a> handle's method (easily done as the
  95 first argument to the existing call is the correct handle to use).</p>
  96       <p>In addition, the <a href="../api_reference/C/lockstat.html" class="olink">DB_ENV-&gt;lock_stat()</a> call has been changed in the 4.0
  97 release to take a flags argument.  To leave their historic behavior
  98 unchanged, applications should add a final argument of 0 to any calls
  99 made to <a href="../api_reference/C/lockstat.html" class="olink">DB_ENV-&gt;lock_stat()</a>.</p>
 100       <p>The C++ and Java APIs for the DbLock::put (DbLock.put) method was
 101 reworked in the 4.0 release to make the lock put interface a method of
 102 the <a href="../api_reference/C/env.html" class="olink">DB_ENV</a> handle rather than the DbLock handle.  Applications
 103 calling the DbLock::put or DbLock.put method should update their calls
 104 to use the enclosing <a href="../api_reference/C/env.html" class="olink">DB_ENV</a> handle's method (easily done as the
 105 first argument to the existing call is the correct handle to use).</p>
 106     </div>
 107     <div class="navfooter">
 108       <hr />
 109       <table width="100%" summary="Navigation footer">
 110         <tr>
 111           <td width="40%" align="left"><a accesskey="p" href="upgrade_4_0_deadlock.html">Prev</a> </td>
 112           <td width="20%" align="center">
 113             <a accesskey="u" href="upgrade_4_0_toc.html">Up</a>
 114           </td>
 115           <td width="40%" align="right"> <a accesskey="n" href="upgrade_4_0_log.html">Next</a></td>
 116         </tr>
 117         <tr>
 118           <td width="40%" align="left" valign="top">db_deadlock </td>
 119           <td width="20%" align="center">
 120             <a accesskey="h" href="index.html">Home</a>
 121           </td>
 122           <td width="40%" align="right" valign="top"> log_XXX</td>
 123         </tr>
 124       </table>
 125     </div>
 126   </body>
 127 </html>