mirror of
https://github.com/berkeleydb/libdb.git
synced 2024-11-16 09:06:25 +00:00
235 lines
9.7 KiB
HTML
235 lines
9.7 KiB
HTML
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
|
||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
||
<html xmlns="http://www.w3.org/1999/xhtml">
|
||
<head>
|
||
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
|
||
<title>Building a small memory footprint library</title>
|
||
<link rel="stylesheet" href="gettingStarted.css" type="text/css" />
|
||
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2" />
|
||
<link rel="start" href="index.html" title="Berkeley DB Installation and Build Guide" />
|
||
<link rel="up" href="build_unix.html" title="Chapter 7. Building Berkeley DB for UNIX/POSIX" />
|
||
<link rel="prev" href="build_unix_sql.html" title="Configuring the SQL Interface" />
|
||
<link rel="next" href="build_unix_flags.html" title="Changing compile or load options" />
|
||
</head>
|
||
<body>
|
||
<div xmlns="" class="navheader">
|
||
<div class="libver">
|
||
<p>Library Version 11.2.5.3</p>
|
||
</div>
|
||
<table width="100%" summary="Navigation header">
|
||
<tr>
|
||
<th colspan="3" align="center">Building a small memory footprint library</th>
|
||
</tr>
|
||
<tr>
|
||
<td width="20%" align="left"><a accesskey="p" href="build_unix_sql.html">Prev</a> </td>
|
||
<th width="60%" align="center">Chapter 7.
|
||
Building Berkeley DB for UNIX/POSIX
|
||
</th>
|
||
<td width="20%" align="right"> <a accesskey="n" href="build_unix_flags.html">Next</a></td>
|
||
</tr>
|
||
</table>
|
||
<hr />
|
||
</div>
|
||
<div class="sect1" lang="en" xml:lang="en">
|
||
<div class="titlepage">
|
||
<div>
|
||
<div>
|
||
<h2 class="title" style="clear: both"><a id="build_unix_small"></a>Building a small memory footprint library</h2>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
<p>
|
||
There are a set of configuration options to assist you in building
|
||
a small memory footprint library. These configuration options turn
|
||
off specific functionality in the Berkeley DB library, reducing the
|
||
code size. These configuration options include:
|
||
</p>
|
||
<div class="variablelist">
|
||
<dl>
|
||
<dt>
|
||
<span class="term">
|
||
<code class="literal">--enable-smallbuild</code>
|
||
</span>
|
||
</dt>
|
||
<dd>
|
||
<p>
|
||
Equivalent to individually specifying all of the following
|
||
configuration options. In addition, when compiling
|
||
building with the GNU gcc compiler, this option uses the
|
||
<code class="literal">-Os</code> compiler build flag instead of the
|
||
default <code class="literal">-O3</code>.
|
||
</p>
|
||
<div class="variablelist">
|
||
<dl>
|
||
<dt>
|
||
<span class="term">
|
||
<code class="literal">--with-cryptography=no</code>
|
||
</span>
|
||
</dt>
|
||
<dd>
|
||
Builds Berkeley DB without support for cryptography.
|
||
</dd>
|
||
<dt>
|
||
<span class="term">
|
||
<code class="literal">--disable-hash</code>
|
||
</span>
|
||
</dt>
|
||
<dd>
|
||
Builds Berkeley DB without support for the Hash access
|
||
method.
|
||
</dd>
|
||
<dt>
|
||
<span class="term">
|
||
<code class="literal">--disable-heap</code>
|
||
</span>
|
||
</dt>
|
||
<dd>
|
||
Builds Berkeley DB without support for the
|
||
Heap access method.
|
||
</dd>
|
||
<dt>
|
||
<span class="term">
|
||
<code class="literal">--disable-queue</code>
|
||
</span>
|
||
</dt>
|
||
<dd>
|
||
Builds Berkeley DB without support for the Queue access
|
||
method.
|
||
</dd>
|
||
<dt>
|
||
<span class="term">
|
||
<code class="literal">--disable-replication</code>
|
||
</span>
|
||
</dt>
|
||
<dd>
|
||
Builds Berkeley DB without support for the database
|
||
environment replication.
|
||
</dd>
|
||
<dt>
|
||
<span class="term">
|
||
<code class="literal">--disable-statistics</code>
|
||
</span>
|
||
</dt>
|
||
<dd>
|
||
Builds Berkeley DB without support for the statistics
|
||
interfaces.
|
||
</dd>
|
||
<dt>
|
||
<span class="term">
|
||
<code class="literal">--disable-verify</code>
|
||
</span>
|
||
</dt>
|
||
<dd>
|
||
Builds Berkeley DB without support for database
|
||
verification.
|
||
</dd>
|
||
<dt>
|
||
<span class="term">
|
||
<code class="literal">--enable-stripped_messages</code>
|
||
</span>
|
||
</dt>
|
||
<dd>
|
||
<p>
|
||
Strips message text from the error messages issued by
|
||
Berkeley DB. This can reduce the size of the library by
|
||
roughly another 22KB.
|
||
</p>
|
||
<p>
|
||
If your library has stripped messages, you can get an idea of
|
||
what text should be issued for a given error message by using
|
||
the <a href="../articles/mssgtxt/index.html" class="olink">Message
|
||
Reference for Stripped Libraries</a> guide.
|
||
</p>
|
||
</dd>
|
||
</dl>
|
||
</div>
|
||
</dd>
|
||
</dl>
|
||
</div>
|
||
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
|
||
<h3 class="title">Note</h3>
|
||
<p>
|
||
<code class="literal">--disable-cryptography</code> and
|
||
<code class="literal">--enable-cryptography</code> are
|
||
deprecated in the Berkeley DB 11gR2 release.
|
||
Use <code class="literal">--with-cryptography=no</code>
|
||
and <code class="literal">--with-cryptography=yes</code>
|
||
instead.
|
||
</p>
|
||
</div>
|
||
<p>
|
||
The following configuration options will increase the size of the
|
||
Berkeley DB library dramatically and are only useful when debugging
|
||
applications:
|
||
</p>
|
||
<div class="variablelist">
|
||
<dl>
|
||
<dt>
|
||
<span class="term">
|
||
<a class="link" href="build_unix_conf.html#build_unix_conf.--enable-debug">--enable-debug</a>
|
||
</span>
|
||
</dt>
|
||
<dd>Build Berkeley DB with symbols for debugging.</dd>
|
||
<dt>
|
||
<span class="term">
|
||
<a class="link" href="build_unix_conf.html#build_unix_conf.--enable-debug_rop">--enable-debug_rop</a>
|
||
</span>
|
||
</dt>
|
||
<dd>Build Berkeley DB with read-operation logging.</dd>
|
||
<dt>
|
||
<span class="term">
|
||
<a class="link" href="build_unix_conf.html#build_unix_conf.--enable-debug_wop">--enable-debug_wop</a>
|
||
</span>
|
||
</dt>
|
||
<dd>Build Berkeley DB with write-operation logging.</dd>
|
||
<dt>
|
||
<span class="term">
|
||
<a class="link" href="build_unix_conf.html#build_unix_conf.--enable-diagnostic">--enable-diagnostic</a>
|
||
</span>
|
||
</dt>
|
||
<dd>Build Berkeley DB with run-time debugging checks.</dd>
|
||
</dl>
|
||
</div>
|
||
<p>
|
||
In addition, static libraries are usually smaller than shared
|
||
libraries. By default Berkeley DB will build both shared and
|
||
static libraries. To build only a static library, configure
|
||
Berkeley DB with the
|
||
<a class="xref" href="build_unix_conf.html" title="Configuring Berkeley DB">Configuring Berkeley DB</a>
|
||
option.
|
||
</p>
|
||
<p>
|
||
The size of the Berkeley DB library varies depending on the
|
||
compiler, machine architecture, and configuration options. As an
|
||
estimate, production Berkeley DB libraries built with GNU gcc
|
||
version 4.X compilers have footprints in the range of 600KB to
|
||
1.4MB on 32-bit x86 architectures, and in the range of 700KB to
|
||
1.6MB on 64-bit x86 architectures.
|
||
</p>
|
||
<p>
|
||
For assistance in further reducing the size of the Berkeley DB
|
||
library, or in building small memory footprint libraries on other
|
||
systems, please contact Berkeley DB support.
|
||
</p>
|
||
</div>
|
||
<div class="navfooter">
|
||
<hr />
|
||
<table width="100%" summary="Navigation footer">
|
||
<tr>
|
||
<td width="40%" align="left"><a accesskey="p" href="build_unix_sql.html">Prev</a> </td>
|
||
<td width="20%" align="center">
|
||
<a accesskey="u" href="build_unix.html">Up</a>
|
||
</td>
|
||
<td width="40%" align="right"> <a accesskey="n" href="build_unix_flags.html">Next</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td width="40%" align="left" valign="top">Configuring the SQL Interface </td>
|
||
<td width="20%" align="center">
|
||
<a accesskey="h" href="index.html">Home</a>
|
||
</td>
|
||
<td width="40%" align="right" valign="top"> Changing compile or load options</td>
|
||
</tr>
|
||
</table>
|
||
</div>
|
||
</body>
|
||
</html>
|