1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
|
<?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>
|
