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
236
237
238
239
240
241
242
243
244
245
246
247
248
249
|
<?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 12.1.6.1</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">Berkeley DB Message Reference Guide</a>.
</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>
|
