1<!--$Id: compile.so,v 10.12 2001/03/13 20:39:46 bostic Exp $-->
2<!--Copyright (c) 1997,2008 Oracle.  All rights reserved.-->
3<!--See the file LICENSE for redistribution information.-->
4<html>
5<head>
6<title>Berkeley DB Reference Guide: Compile-time configuration</title>
7<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit.">
8<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++">
9</head>
10<body bgcolor=white>
11<table width="100%"><tr valign=top>
12<td><b><dl><dt>Berkeley DB Reference Guide:<dd>Debugging Applications</dl></b></td>
13<td align=right><a href="../debug/intro.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../toc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../debug/runtime.html"><img src="../../images/next.gif" alt="Next"></a>
14</td></tr></table>
15<p align=center><b>Compile-time configuration</b></p>
16<p>There are three compile-time configuration options that assist in
17debugging Berkeley DB and Berkeley DB applications:</p>
18<br>
19<b><a href="../../ref/build_unix/conf.html#--enable-debug">--enable-debug</a></b><ul compact><li>If you want to build Berkeley DB with <b>-g</b> as the C and C++ compiler
20flag, enter --enable-debug as an argument to configure. This will create
21Berkeley DB with debugging symbols, as well as load various Berkeley DB routines
22that can be called directly from a debugger to display database page
23content, cursor queues, and so forth.  (Note that the <b>-O</b>
24optimization flag will still be specified.  To compile with only the
25<b>-g</b>, explicitly set the <b>CFLAGS</b> environment variable
26before configuring.)</ul>
27<b><a href="../../ref/build_unix/conf.html#--enable-diagnostic">--enable-diagnostic</a></b><ul compact><li>If you want to build Berkeley DB with debugging run-time sanity checks and with
28DIAGNOSTIC #defined during compilation, enter --enable-diagnostic as an
29argument to configure. This will cause a number of special checks to be
30performed when Berkeley DB is running. This flag should not be defined when
31configuring to build production binaries because it degrades performance.</ul>
32<b><a href="../../ref/build_unix/conf.html#--enable-umrw">--enable-umrw</a></b><ul compact><li>When compiling Berkeley DB for use in run-time memory consistency checkers
33(in particular, programs that look for reads and writes of uninitialized
34memory), use --enable-umrw as an argument to configure.  This
35guarantees, among other things, that Berkeley DB will completely initialize
36allocated pages rather than initializing only the minimum necessary
37amount.</ul>
38<br>
39<table width="100%"><tr><td><br></td><td align=right><a href="../debug/intro.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../toc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../debug/runtime.html"><img src="../../images/next.gif" alt="Next"></a>
40</td></tr></table>
41<p><font size=1>Copyright (c) 1996,2008 Oracle.  All rights reserved.</font>
42</body>
43</html>
44