← Back to branch summary

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

« back to all changes in this revision

Viewing changes to libdb/docs/ref/debug/intro.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
https://launchpad.net/bugs/42199
https://launchpad.net/bugs/229669
https://launchpad.net/bugs/173703
https://launchpad.net/bugs/360344
https://launchpad.net/bugs/508494
* 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:
libdb/docs/ref/debug/intro.html
1
 
<!--$Id$-->
2
 
<!--Copyright 1997-2002 by Sleepycat Software, Inc.-->
3
 
<!--All rights reserved.-->
4
 
<!--See the file LICENSE for redistribution information.-->
5
 
<html>
6
 
<head>
7
 
<title>Berkeley DB Reference Guide: Introduction</title>
8
 
<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit.">
9
 
<meta name="keywords" content="embedded,database,programmatic,toolkit,b+tree,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,java,C,C++">
10
 
</head>
11
 
<body bgcolor=white>
12
 
<a name="2"><!--meow--></a>
13
 
<table width="100%"><tr valign=top>
14
 
<td><h3><dl><dt>Berkeley DB Reference Guide:<dd>Debugging Applications</dl></h3></td>
15
 
<td align=right><a href="../../ref/install/rpm.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../../reftoc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../../ref/debug/compile.html"><img src="../../images/next.gif" alt="Next"></a>
16
 
</td></tr></table>
17
 
<p>
18
 
<h1 align=center>Introduction</h1>
19
 
<p>Because Berkeley DB is an embedded library, debugging applications that use
20
 
Berkeley DB is both harder and easier than debugging a separate server.
21
 
Debugging can be harder because when a problem arises, it is not always
22
 
readily apparent whether the problem is in the application, is in the
23
 
database library, or is a result of an unexpected interaction between
24
 
the two.  Debugging can be easier because it is easier to track down a
25
 
problem when you can review a stack trace rather than deciphering
26
 
interprocess communication messages.  This chapter is intended to assist
27
 
you with debugging applications and reporting bugs to us so that we can
28
 
provide you with the correct answer or fix as quickly as possible.
29
 
<p>When you encounter a problem, there are a few general actions you can
30
 
take:
31
 
<p><dl compact>
32
 
<p><dt>Review the Berkeley DB error output<dd>If an error output mechanism has been configured in the Berkeley DB
33
 
environment, additional run-time error messages are made available to
34
 
the applications.  If you are not using an environment, it is well worth
35
 
modifying your application to create one so that you can get more
36
 
detailed error messages.  See <a href="runtime.html">Run-time error
37
 
information</a> for more information on configuring Berkeley DB to output these
38
 
error messages.
39
 
<p><dt>Review <a href="../../api_c/env_set_verbose.html">DB_ENV-&gt;set_verbose</a><dd>Check the list of flags for the <a href="../../api_c/env_set_verbose.html">DB_ENV-&gt;set_verbose</a> function, and
40
 
see if any of them will produce additional information that might help
41
 
understand the problem.
42
 
<p><dt>Add run-time diagnostics<dd>You can configure and build Berkeley DB to perform run-time diagnostics.  (By
43
 
default, these checks are not done because they can seriously impact
44
 
performance.)  See <a href="compile.html">Compile-time configuration</a> for more
45
 
information.
46
 
<p><dt>Apply all available patches<dd>Before reporting a problem to Sleepycat Software, please upgrade to the
47
 
latest Sleepycat Software release of Berkeley DB, if possible, or at least
48
 
make sure you have applied any updates available for your release from
49
 
the <a href="http://www.sleepycat.com/update/index.html">Sleepycat
50
 
Software web site</a>.
51
 
<p><dt>Run the test suite<dd>If you see repeated failures or failures of simple test cases, run the
52
 
Berkeley DB test suite to determine whether the distribution of Berkeley DB you are
53
 
using was built and configured correctly.
54
 
</dl>
55
 
<table width="100%"><tr><td><br></td><td align=right><a href="../../ref/install/rpm.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../../reftoc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../../ref/debug/compile.html"><img src="../../images/next.gif" alt="Next"></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>