eagain.html   [plain text]


<!--$Id: eagain.so,v 11.6 2001/07/10 13:16:34 bostic Exp $-->
<!--Copyright (c) 1997,2008 Oracle.  All rights reserved.-->
<!--See the file LICENSE for redistribution information.-->
<html>
<head>
<title>Berkeley DB Reference Guide: Release 3.0: EAGAIN</title>
<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit.">
<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++">
</head>
<body bgcolor=white>
<table width="100%"><tr valign=top>
<td><b><dl><dt>Berkeley DB Reference Guide:<dd>Upgrading Berkeley DB Applications</dl></b></td>
<td align=right><a href="../upgrade.3.0/lock_notheld.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/eacces.html"><img src="../../images/next.gif" alt="Next"></a>
</td></tr></table>
<p align=center><b>Release 3.0: EAGAIN</b></p>
<p>Historically, the Berkeley DB interfaces have returned the POSIX error value
EAGAIN to indicate a deadlock.  This has been removed from the Berkeley DB 3.0
release in order to make it possible for applications to distinguish
between EAGAIN errors returned by the system and returns from Berkeley DB
indicating deadlock.</p>
<p>The application should be searched for any occurrences of EAGAIN. For
each of these, any that are checking for a deadlock return from Berkeley DB
should be changed to check for the DB_LOCK_DEADLOCK return value.</p>
<p>If, for any reason, this is a difficult change for the application to
make, the <b>include/db.src</b> distribution file should be modified to
translate all returns of DB_LOCK_DEADLOCK to EAGAIN.  Search for the
string EAGAIN in that file, there is a comment that describes how to make
the change.</p>
<table width="100%"><tr><td><br></td><td align=right><a href="../upgrade.3.0/lock_notheld.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/eacces.html"><img src="../../images/next.gif" alt="Next"></a>
</td></tr></table>
<p><font size=1>Copyright (c) 1996,2008 Oracle.  All rights reserved.</font>
</body>
</html>