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
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
|
<?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>Chapter 7. Building Berkeley DB for UNIX/POSIX</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="index.html" title="Berkeley DB Installation and Build Guide" />
<link rel="prev" href="build_winec_intro.html" title="Building for Windows Embedded Compact 7" />
<link rel="next" href="build_unix_conf.html" title="Configuring Berkeley DB" />
</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">Chapter 7. Building Berkeley DB for UNIX/POSIX
</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="build_winec_intro.html">Prev</a> </td>
<th width="60%" align="center"> </th>
<td width="20%" align="right"> <a accesskey="n" href="build_unix_conf.html">Next</a></td>
</tr>
</table>
<hr />
</div>
<div class="chapter" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title"><a id="build_unix"></a>Chapter 7. Building Berkeley DB for UNIX/POSIX
</h2>
</div>
</div>
</div>
<div class="toc">
<p>
<b>Table of Contents</b>
</p>
<dl>
<dt>
<span class="sect1">
<a href="build_unix.html#build_unix_intro">Building for UNIX/POSIX</a>
</span>
</dt>
<dd>
<dl>
<dt>
<span class="sect2">
<a href="build_unix.html#build_unix_sqlinter">Building the Berkeley DB SQL Interface</a>
</span>
</dt>
</dl>
</dd>
<dt>
<span class="sect1">
<a href="build_unix_conf.html">Configuring Berkeley DB</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="build_unix_sql.html">Configuring the SQL
Interface</a>
</span>
</dt>
<dd>
<dl>
<dt>
<span class="sect2">
<a href="build_unix_sql.html#config_sql">Changing Compile Options</a>
</span>
</dt>
<dt>
<span class="sect2">
<a href="build_unix_sql.html#idp698856">Enabling Extensions</a>
</span>
</dt>
<dt>
<span class="sect2">
<a href="build_unix_sql.html#build_unix_jdbc">Building the JDBC Driver</a>
</span>
</dt>
<dt>
<span class="sect2">
<a href="build_unix_sql.html#idp704816">Using the JDBC Driver</a>
</span>
</dt>
<dt>
<span class="sect2">
<a href="build_unix_sql.html#idp736952">Building the ODBC Driver</a>
</span>
</dt>
<dt>
<span class="sect2">
<a href="build_unix_sql.html#bfile">Building the BFILE extension</a>
</span>
</dt>
</dl>
</dd>
<dt>
<span class="sect1">
<a href="build_unix_small.html">Building a small memory footprint library</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="build_unix_flags.html">Changing compile or load
options</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="cross_compile_unix.html">Cross-Compiling on
Unix</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="build_unix_install.html">Installing Berkeley
DB</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="build_unix_shlib.html">Dynamic shared libraries</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="build_unix_test.html">Running the test suite under
UNIX</a>
</span>
</dt>
<dd>
<dl>
<dt>
<span class="sect2">
<a href="build_unix_test.html#build_unix_test_sql">Building SQL Test Suite on Unix</a>
</span>
</dt>
</dl>
</dd>
<dt>
<span class="sect1">
<a href="build_unix_notes.html">Architecture independent FAQ</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="build_unix_aix.html">AIX</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="build_unix_freebsd.html">FreeBSD</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="build_unix_iphone.html">Apple iOS (iPhone OS)</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="build_unix_irix.html">IRIX</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="build_unix_linux.html">Linux</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="build_unix_macosx.html">Mac OS X</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="build_unix_qnx.html">QNX</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="build_unix_sco.html">SCO</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="build_unix_solaris.html">Solaris</a>
</span>
</dt>
<dt>
<span class="sect1">
<a href="build_unix_sunos.html">SunOS</a>
</span>
</dt>
</dl>
</div>
<div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title" style="clear: both"><a id="build_unix_intro"></a>Building for UNIX/POSIX</h2>
</div>
</div>
</div>
<div class="toc">
<dl>
<dt>
<span class="sect2">
<a href="build_unix.html#build_unix_sqlinter">Building the Berkeley DB SQL Interface</a>
</span>
</dt>
</dl>
</div>
<p>
The Berkeley DB distribution builds up to six separate
libraries: the base C API Berkeley DB library and the optional
C++, Java, Tcl, SQL, and JDBC API libraries. For portability
reasons, each library is standalone and contains the full
Berkeley DB support necessary to build applications; that is,
the C++ API Berkeley DB library does not require any other
Berkeley DB libraries to build and run C++ applications.
</p>
<p>
Building for Linux, Apple iOS (known as iPhone OS
previously), Mac OS X or the QNX Neutrino release is the same
as building for a conventional UNIX platform.
</p>
<p>
The Berkeley DB distribution uses the Free Software
Foundation's <a class="ulink" href="http://www.gnu.org/software/autoconf/autoconf.html" target="_top">autoconf</a>
and <a class="ulink" href="http://www.gnu.org/software/libtool/libtool.html" target="_top">libtool</a>
tools to build on UNIX platforms. In
general, the standard configuration and installation options
for these tools apply to the Berkeley DB distribution.
</p>
<p>
To perform a standard UNIX build of Berkeley DB, change to
the <span class="bold"><strong>build_unix</strong></span> directory and
then enter the following two commands:
</p>
<pre class="programlisting">../dist/configure
make</pre>
<p>
This will build the Berkeley DB library.
</p>
<p>
To install the Berkeley DB library, enter the following
command:
</p>
<pre class="programlisting">make install</pre>
<p>
To rebuild Berkeley DB, enter:
</p>
<pre class="programlisting">make clean
make</pre>
<p>
If you change your mind about how Berkeley DB is to be
configured, you must start from scratch by entering the
following command:
</p>
<pre class="programlisting">make realclean
../dist/configure
make</pre>
<p>
To uninstall Berkeley DB, enter:
</p>
<pre class="programlisting">make uninstall</pre>
<p>
To build multiple UNIX versions of Berkeley DB in the same
source tree, create a new directory at the same level as the
build_unix directory, and then configure and build in that
directory as described previously.
</p>
<div class="sect2" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a id="build_unix_sqlinter"></a>Building the Berkeley DB SQL Interface</h3>
</div>
</div>
</div>
<p>
To perform a standard UNIX build of the Berkeley DB SQL
interface, go to the <span class="bold"><strong>build_unix</strong></span>
directory and then enter the following two commands:
</p>
<pre class="programlisting">../dist/configure --enable-sql
make </pre>
<p>
This creates a library, <code class="literal">libdb_sql</code>,
and a command line tool, <code class="literal">dbsql</code>. You can
create and manipulate SQL databases using the
<code class="literal">dbsql</code> shell.
</p>
<p>
You can optionally provide the
<code class="literal">--enable-sql_compat</code> argument to the
<code class="literal">configure</code> script. In addition to
creating <code class="literal">libdb_sql</code> and
<code class="literal">dbsql</code> this causes a thin wrapper
library called <code class="literal">libsqlite3</code> and a command
line tool called <code class="literal">sqlite3</code> to be built.
This library can be used as a drop-in replacement for
SQLite. The <code class="literal">sqlite3</code> command line tool
is identical to the <code class="literal">dbsql</code> executable
but is named so that existing scripts for SQLite can
easily work with Berkeley DB.
</p>
<pre class="programlisting">
../dist/configure --enable-sql_compat
make </pre>
<p>
There are several arguments you can specify when
configuring the Berkeley DB SQL Interface. See <a class="xref" href="build_unix_sql.html" title="Configuring the SQL Interface">Configuring the SQL
Interface</a> for more information.
</p>
</div>
</div>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="build_winec_intro.html">Prev</a> </td>
<td width="20%" align="center"> </td>
<td width="40%" align="right"> <a accesskey="n" href="build_unix_conf.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">Building for Windows
Embedded Compact 7 </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> Configuring Berkeley DB</td>
</tr>
</table>
</div>
</body>
</html>
|
