~ubuntu-branches/ubuntu/maverick/evolution-data-server/maverick-proposed

« back to all changes in this revision

Viewing changes to libdb/docs/api_c/db_set_paniccall.html

  • Committer: Bazaar Package Importer
  • Author(s): Didier Roche
  • Date: 2010-05-17 17:02:06 UTC
  • mfrom: (1.1.79 upstream) (1.6.12 experimental)
  • Revision ID: james.westby@ubuntu.com-20100517170206-4ufr52vwrhh26yh0
Tags: 2.30.1-1ubuntu1
* Merge from debian experimental. Remaining change:
  (LP: #42199, #229669, #173703, #360344, #508494)
  + debian/control:
    - add Vcs-Bzr tag
    - don't use libgnome
    - Use Breaks instead of Conflicts against evolution 2.25 and earlier.
  + debian/evolution-data-server.install,
    debian/patches/45_libcamel_providers_version.patch:
    - use the upstream versioning, not a Debian-specific one 
  + debian/libedata-book1.2-dev.install, debian/libebackend-1.2-dev.install,
    debian/libcamel1.2-dev.install, debian/libedataserverui1.2-dev.install:
    - install html documentation
  + debian/rules:
    - don't build documentation it's shipped with the tarball

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
<!--$Id$-->
2
 
<!--$Id$-->
3
 
<!--Copyright 1997-2002 by Sleepycat Software, Inc.-->
4
 
<!--All rights reserved.-->
5
 
<!--See the file LICENSE for redistribution information.-->
6
 
<html>
7
 
<head>
8
 
<title>Berkeley DB: DB-&gt;set_paniccall</title>
9
 
<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit.">
10
 
<meta name="keywords" content="embedded,database,programmatic,toolkit,b+tree,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,java,C,C++">
11
 
</head>
12
 
<body bgcolor=white>
13
 
<a name="2"><!--meow--></a>
14
 
<table width="100%"><tr valign=top>
15
 
<td>
16
 
<h1>DB-&gt;set_paniccall</h1>
17
 
</td>
18
 
<td align=right>
19
 
<a href="../api_c/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a>
20
 
</td></tr></table>
21
 
<hr size=1 noshade>
22
 
<tt>
23
 
<h3><pre>
24
 
#include &lt;db.h&gt;
25
 
<p>
26
 
int
27
 
DB-&gt;set_paniccall(DB *db,
28
 
    void (*paniccall)(DB_ENV *, int errval));
29
 
</pre></h3>
30
 
<h1>Description</h1>
31
 
<p>Errors can occur in the Berkeley DB library where the only solution is to shut
32
 
down the application and run recovery (for example, if Berkeley DB is unable
33
 
to allocate heap memory).  In these cases, the value <a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a>
34
 
is returned by Berkeley DB.
35
 
<p>In these cases, it is also often simpler to shut down the application
36
 
when such errors occur rather than to try to gracefully return up the
37
 
stack.  The <a href="../api_c/env_set_paniccall.html">DB_ENV-&gt;set_paniccall</a> and DB-&gt;set_paniccall methods
38
 
are used to specify functions to be called when
39
 
<a href="../ref/program/errorret.html#DB_RUNRECOVERY">DB_RUNRECOVERY</a> is about to be returned from a Berkeley DB interface.
40
 
When called, the <b>dbenv</b> argument will be a reference to the
41
 
current environment, and the <b>errval</b> argument is the error value
42
 
that would have been returned to the calling function.
43
 
<p>For <a href="../api_c/db_class.html">DB</a> handles opened inside of Berkeley DB environments, calling the
44
 
DB-&gt;set_paniccall method affects the entire environment and is equivalent to calling
45
 
the <a href="../api_c/env_set_paniccall.html">DB_ENV-&gt;set_paniccall</a> method.
46
 
<p>The DB-&gt;set_paniccall interface may be called at any time during the life of
47
 
the application.
48
 
<p>The DB-&gt;set_paniccall method returns a non-zero error value on failure and 0 on success.
49
 
<h1>Class</h1>
50
 
<a href="../api_c/db_class.html">DB</a>
51
 
<h1>See Also</h1>
52
 
<a href="../api_c/db_list.html">Databases and Related Methods</a>
53
 
</tt>
54
 
<table width="100%"><tr><td><br></td><td align=right>
55
 
<a href="../api_c/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a>
56
 
</td></tr></table>
57
 
<p><font size=1><a href="http://www.sleepycat.com">Copyright Sleepycat Software</a></font>
58
 
</body>
59
 
</html>