blob: 8713d2a0d4cd479c1e7fba45d723103a7ba20ff3 (
plain)
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
|
<?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>Additional build options</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_win.html" title="Chapter 5. Building Berkeley DB for Windows" />
<link rel="prev" href="win_build_dist_dll.html" title="Distributing DLLs" />
<link rel="next" href="build_win_small.html" title="Building a small memory footprint library" />
</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">Additional build options</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href="win_build_dist_dll.html">Prev</a> </td>
<th width="60%" align="center">Chapter 5. Building Berkeley DB for Windows </th>
<td width="20%" align="right"> <a accesskey="n" href="build_win_small.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="win_additional_options"></a>Additional build options</h2>
</div>
</div>
</div>
<p>
There are several build options that you can configure when
building Berkeley DB on Windows. To specify these, select
<code class="literal">Project
Properties</code>-><code class="literal">C/C++</code>-><code class="literal">Command
Line</code> and add the property.
</p>
<p>
These are some of the additional properties that you can
specify when you are building Berkeley DB on Windows:
</p>
<div class="itemizedlist">
<ul type="disc">
<li>
<p><a id="HAVE_FAILCHK_BROADCAST"></a>
Enable failchk broadcasting. This feature allows
<a href="../api_reference/C/envfailchk.html" class="olink">DB_ENV->failchk()</a> to inform all processes in the environment
that a failure has occurred. Those processes will return
<a href="../programmer_reference/program_errorret.html#program_errorret.DB_RUNRECOVERY" class="olink">
DB_RUNRECOVERY
</a>
rather than hanging for an indefinite amount of time.
</p>
</li>
<li>
<p><a id="HAVE_LOCALIZATION"></a>
<span class="bold"><strong>/D HAVE_LOCALIZATION</strong></span>
</p>
<p>
Enable localized error message text, if available.
This option should not be used when enabling stripped
messages.
</p>
</li>
<li>
<p><a id="HAVE_MIXED_SIZE_ADDRESSING"></a>
<span class="bold"><strong>/D
HAVE_MIXED_SIZE_ADDRESSING</strong></span>
</p>
<p>
Allows for the sharing of the BDB database
environment between 32-bit and 64-bit applications.
Note that if you use this macro to rebuild your
Berkeley DB library, then you need to also rebuild
both your 32-bit and 64-bit applications using
<span class="bold"><strong>/D
HAVE_MIXED_SIZE_ADDRESSING</strong></span>.
</p>
<p>
Note that use of this macro means that private
environments are disabled for the library.
</p>
</li>
<li>
<p><a id="HAVE_STRIPPED_MESSAGES"></a>
<span class="bold"><strong>/D
HAVE_STRIPPED_MESSAGES</strong></span>
</p>
<p>
Causes all error messages to be stripped of their
textual information. This option should not be used
when enabling localization support. Use of this
property can reduce your library footprint by up to
42KB (for DLLs) or 98KB (for a .lib).
</p>
<p>
Note that this option is automatically enabled if
you build using the <code class="filename">db_small</code>
project name. For more information on building a small
library, see <a class="xref" href="build_win_small.html" title="Building a small memory footprint library">Building a small memory
footprint library</a>.
</p>
<p>
If you use this build option, 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>
</li>
<li>
<p><a id="DIAGNOSTIC"></a>
<span class="bold"><strong>/D DIAGNOSTIC</strong></span>
</p>
<p>
Included automatically in the Debug build. Allows a
number of additional checks to be performed when BDB
is running, and also causes some failures to trigger
process abort rather than returning errors to the
application. Applications built using this option
should not share database environments with
applications built without this option. The
<code class="literal">DIAGNOSTIC</code> option should not be
specified when configuring to build production
binaries because it degrades performance.
</p>
</li>
<li>
<p><a id="UMRW"></a>
<span class="bold"><strong>/D UMRW</strong></span>
</p>
<p>
Rational Software's Purify product and other
software analysis run-time tools complain about
uninitialized reads/writes of structure fields whose
only purpose is padding, as well as when heap memory
that was never initialized is written to disk. Specify
this option during configuration to mask these errors.
The <code class="literal">UMRW</code> option should not be
specified when configuring to build production
binaries.
</p>
</li>
</ul>
</div>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href="win_build_dist_dll.html">Prev</a> </td>
<td width="20%" align="center">
<a accesskey="u" href="build_win.html">Up</a>
</td>
<td width="40%" align="right"> <a accesskey="n" href="build_win_small.html">Next</a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top">Distributing DLLs </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>
<td width="40%" align="right" valign="top"> Building a small memory
footprint library</td>
</tr>
</table>
</div>
</body>
</html>
|
