Debian Codegraph @

docs/installation/build_unix_small.html

raw
1 <?xml version="1.0" encoding="UTF-8" standalone="no"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml">
4 <head>
5 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
6 <title>Building a small memory footprint library</title>
7 <link rel="stylesheet" href="gettingStarted.css" type="text/css" />
8 <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" />
9 <link rel="start" href="index.html" title="Berkeley DB Installation and Build Guide" />
10 <link rel="up" href="build_unix.html" title="Chapter 7.  Building Berkeley DB for UNIX/POSIX" />
11 <link rel="prev" href="build_unix_sql.html" title="Configuring the SQL Interface" />
12 <link rel="next" href="build_unix_flags.html" title="Changing compile or load options" />
13 </head>
14 <body>
15 <div xmlns="" class="navheader">
16 <div class="libver">
17 <p>Library Version 11.2.5.3</p>
18 </div>
19 <table width="100%" summary="Navigation header">
20 <tr>
21 <th colspan="3" align="center">Building a small memory footprint library</th>
22 </tr>
23 <tr>
24 <td width="20%" align="left"><a accesskey="p" href="build_unix_sql.html">Prev</a> </td>
25 <th width="60%" align="center">Chapter 7. 
26 Building Berkeley DB for UNIX/POSIX
27 </th>
28 <td width="20%" align="right"> <a accesskey="n" href="build_unix_flags.html">Next</a></td>
29 </tr>
30 </table>
31 <hr />
32 </div>
33 <div class="sect1" lang="en" xml:lang="en">
34 <div class="titlepage">
35 <div>
36 <div>
37 <h2 class="title" style="clear: both"><a id="build_unix_small"></a>Building a small memory footprint library</h2>
38 </div>
39 </div>
40 </div>
41 <p>
42 There are a set of configuration options to assist you in building
43 a small memory footprint library. These configuration options turn
44 off specific functionality in the Berkeley DB library, reducing the
45 code size. These configuration options include:
46 </p>
47 <div class="variablelist">
48 <dl>
49 <dt>
50 <span class="term">
51 <code class="literal">--enable-smallbuild</code>
52 </span>
53 </dt>
54 <dd>
55 <p>
56 Equivalent to individually specifying all of the following
57 configuration options. In addition, when compiling
58 building with the GNU gcc compiler, this option uses the
59 <code class="literal">-Os</code> compiler build flag instead of the
60 default <code class="literal">-O3</code>.
61 </p>
62 <div class="variablelist">
63 <dl>
64 <dt>
65 <span class="term">
66 <code class="literal">--with-cryptography=no</code>
67 </span>
68 </dt>
69 <dd>
70 Builds Berkeley DB without support for cryptography.
71 </dd>
72 <dt>
73 <span class="term">
74 <code class="literal">--disable-hash</code>
75 </span>
76 </dt>
77 <dd>
78 Builds Berkeley DB without support for the Hash access
79 method.
80 </dd>
81 <dt>
82 <span class="term">
83 <code class="literal">--disable-heap</code>
84 </span>
85 </dt>
86 <dd>
87 Builds Berkeley DB without support for the
88 Heap access method.
89 </dd>
90 <dt>
91 <span class="term">
92 <code class="literal">--disable-queue</code>
93 </span>
94 </dt>
95 <dd>
96 Builds Berkeley DB without support for the Queue access
97 method.
98 </dd>
99 <dt>
100 <span class="term">
101 <code class="literal">--disable-replication</code>
102 </span>
103 </dt>
104 <dd>
105 Builds Berkeley DB without support for the database
106 environment replication.
107 </dd>
108 <dt>
109 <span class="term">
110 <code class="literal">--disable-statistics</code>
111 </span>
112 </dt>
113 <dd>
114 Builds Berkeley DB without support for the statistics
115 interfaces.
116 </dd>
117 <dt>
118 <span class="term">
119 <code class="literal">--disable-verify</code>
120 </span>
121 </dt>
122 <dd>
123 Builds Berkeley DB without support for database
124 verification.
125 </dd>
126 <dt>
127 <span class="term">
128 <code class="literal">--enable-stripped_messages</code>
129 </span>
130 </dt>
131 <dd>
132 <p>
133 Strips message text from the error messages issued by
134 Berkeley DB. This can reduce the size of the library by
135 roughly another 22KB.
136 </p>
137 <p>
138 If your library has stripped messages, you can get an idea of
139 what text should be issued for a given error message by using
140 the <a href="../articles/mssgtxt/index.html" class="olink">Message
141 Reference for Stripped Libraries</a> guide.
142 </p>
143 </dd>
144 </dl>
145 </div>
146 </dd>
147 </dl>
148 </div>
149 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
150 <h3 class="title">Note</h3>
151 <p>
152 <code class="literal">--disable-cryptography</code> and
153 <code class="literal">--enable-cryptography</code> are
154 deprecated in the Berkeley DB 11gR2 release.
155 Use <code class="literal">--with-cryptography=no</code>
156 and <code class="literal">--with-cryptography=yes</code>
157 instead.
158 </p>
159 </div>
160 <p>
161 The following configuration options will increase the size of the
162 Berkeley DB library dramatically and are only useful when debugging
163 applications:
164 </p>
165 <div class="variablelist">
166 <dl>
167 <dt>
168 <span class="term">
169 <a class="link" href="build_unix_conf.html#build_unix_conf.--enable-debug">--enable-debug</a>
170 </span>
171 </dt>
172 <dd>Build Berkeley DB with symbols for debugging.</dd>
173 <dt>
174 <span class="term">
175 <a class="link" href="build_unix_conf.html#build_unix_conf.--enable-debug_rop">--enable-debug_rop</a>
176 </span>
177 </dt>
178 <dd>Build Berkeley DB with read-operation logging.</dd>
179 <dt>
180 <span class="term">
181 <a class="link" href="build_unix_conf.html#build_unix_conf.--enable-debug_wop">--enable-debug_wop</a>
182 </span>
183 </dt>
184 <dd>Build Berkeley DB with write-operation logging.</dd>
185 <dt>
186 <span class="term">
187 <a class="link" href="build_unix_conf.html#build_unix_conf.--enable-diagnostic">--enable-diagnostic</a>
188 </span>
189 </dt>
190 <dd>Build Berkeley DB with run-time debugging checks.</dd>
191 </dl>
192 </div>
193 <p>
194 In addition, static libraries are usually smaller than shared
195 libraries. By default Berkeley DB will build both shared and
196 static libraries. To build only a static library, configure
197 Berkeley DB with the
198 <a class="xref" href="build_unix_conf.html" title="Configuring Berkeley DB">Configuring Berkeley DB</a>
199 option.
200 </p>
201 <p>
202 The size of the Berkeley DB library varies depending on the
203 compiler, machine architecture, and configuration options. As an
204 estimate, production Berkeley DB libraries built with GNU gcc
205 version 4.X compilers have footprints in the range of 600KB to
206 1.4MB on 32-bit x86 architectures, and in the range of 700KB to
207 1.6MB on 64-bit x86 architectures.
208 </p>
209 <p>
210 For assistance in further reducing the size of the Berkeley DB
211 library, or in building small memory footprint libraries on other
212 systems, please contact Berkeley DB support.
213 </p>
214 </div>
215 <div class="navfooter">
216 <hr />
217 <table width="100%" summary="Navigation footer">
218 <tr>
219 <td width="40%" align="left"><a accesskey="p" href="build_unix_sql.html">Prev</a> </td>
220 <td width="20%" align="center">
221 <a accesskey="u" href="build_unix.html">Up</a>
222 </td>
223 <td width="40%" align="right"> <a accesskey="n" href="build_unix_flags.html">Next</a></td>
224 </tr>
225 <tr>
226 <td width="40%" align="left" valign="top">Configuring the SQL Interface </td>
227 <td width="20%" align="center">
228 <a accesskey="h" href="index.html">Home</a>
229 </td>
230 <td width="40%" align="right" valign="top"> Changing compile or load options</td>
231 </tr>
232 </table>
233 </div>
234 </body>
235 </html>