greg/libdb
1
0
Fork 0
mirror of https://github.com/berkeleydb/libdb.git synced 2024-11-16 17:16:25 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
libdb/docs/installation/build_unix_small.html

235 lines
9.7 KiB
HTML
Raw Normal View History

Release 5.2.28 on 6/10/2011
2011-09-13 17:44:24 +00:00
<?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.2</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>
Release 5.2.36 on 9/14/2022
2011-12-20 00:07:10 +00:00
<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>
Release 5.2.28 on 6/10/2011
2011-09-13 17:44:24 +00:00
</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 3.X compilers have footprints in the range of 400KB to
1.2MB on 32-bit x86 architectures, and in the range of 500KB to
1.4MB 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>
Reference in a new issue Copy permalink