summaryrefslogtreecommitdiff
path: root/docs/installation/build_win.html
diff options
context:
space:
mode:
Diffstat (limited to 'docs/installation/build_win.html')
-rw-r--r--docs/installation/build_win.html326
1 files changed, 229 insertions, 97 deletions
diff --git a/docs/installation/build_win.html b/docs/installation/build_win.html
index b03fd1d8..ac6a2267 100644
--- a/docs/installation/build_win.html
+++ b/docs/installation/build_win.html
@@ -8,22 +8,20 @@
<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_android_config.html" title="Android Configuration Options" />
+ <link rel="prev" href="build_android_adfmobile.html" title="Using the JDBC Driver in ADF Mobile for Android" />
<link rel="next" href="win_build64.html" title="Building Berkeley DB for 64-bit Windows" />
</head>
<body>
<div xmlns="" class="navheader">
<div class="libver">
- <p>Library Version 11.2.5.3</p>
+ <p>Library Version 12.1.6.1</p>
</div>
<table width="100%" summary="Navigation header">
<tr>
- <th colspan="3" align="center">Chapter 5. 
- Building Berkeley DB for Windows
- </th>
+ <th colspan="3" align="center">Chapter 5.  Building Berkeley DB for Windows </th>
</tr>
<tr>
- <td width="20%" align="left"><a accesskey="p" href="build_android_config.html">Prev</a> </td>
+ <td width="20%" align="left"><a accesskey="p" href="build_android_adfmobile.html">Prev</a> </td>
<th width="60%" align="center"> </th>
<td width="20%" align="right"> <a accesskey="n" href="win_build64.html">Next</a></td>
</tr>
@@ -34,9 +32,7 @@
<div class="titlepage">
<div>
<div>
- <h2 class="title"><a id="build_win"></a>Chapter 5. 
- Building Berkeley DB for Windows
- </h2>
+ <h2 class="title"><a id="build_win"></a>Chapter 5.  Building Berkeley DB for Windows </h2>
</div>
</div>
</div>
@@ -54,22 +50,27 @@
<dl>
<dt>
<span class="sect2">
- <a href="build_win.html#idm1531520">Visual C++ .NET 2010</a>
+ <a href="build_win.html#idp283736">Visual C++ .NET 2012</a>
</span>
</dt>
<dt>
<span class="sect2">
- <a href="build_win.html#idm232112">Visual C++ .NET 2008</a>
+ <a href="build_win.html#idp270168">Visual C++ .NET 2010</a>
</span>
</dt>
<dt>
<span class="sect2">
- <a href="build_win.html#idm67456">Visual C++ .NET 2005</a>
+ <a href="build_win.html#idp285656">Visual C++ .NET 2008</a>
</span>
</dt>
<dt>
<span class="sect2">
- <a href="build_win.html#idm1085168">Build results</a>
+ <a href="build_win.html#idp292968">Visual C++ .NET 2005</a>
+ </span>
+ </dt>
+ <dt>
+ <span class="sect2">
+ <a href="build_win.html#idp295544">Build results</a>
</span>
</dt>
</dl>
@@ -83,7 +84,7 @@
<dl>
<dt>
<span class="sect2">
- <a href="win_build64.html#idm80112">x64 build with Visual Studio 2005 or newer</a>
+ <a href="win_build64.html#idp269712">x64 build with Visual Studio 2005 or newer</a>
</span>
</dt>
</dl>
@@ -122,18 +123,22 @@
<dl>
<dt>
<span class="sect2">
- <a href="build_win_sql.html#idm1386992">Binary Compatibility With SQLite</a>
+ <a href="build_win_sql.html#idp339096">Binary Compatibility With SQLite</a>
+ </span>
+ </dt>
+ <dt>
+ <span class="sect2">
+ <a href="build_win_sql.html#idp335872">Setting Encryption</a>
</span>
</dt>
<dt>
<span class="sect2">
- <a href="build_win_sql.html#idm1146112">Setting Preprocessor Flags
- </a>
+ <a href="build_win_sql.html#idp265480">Changing Compile Options</a>
</span>
</dt>
<dt>
<span class="sect2">
- <a href="build_win_sql.html#idm1193168">Enabling Extensions</a>
+ <a href="build_win_sql.html#idp224800">Enabling Extensions</a>
</span>
</dt>
<dt>
@@ -148,18 +153,22 @@
</dt>
<dt>
<span class="sect2">
- <a href="build_win_sql.html#idm313872">Using the JDBC Driver</a>
+ <a href="build_win_sql.html#idp339720">Using the JDBC Driver</a>
</span>
</dt>
<dt>
<span class="sect2">
- <a href="build_win_sql.html#idm1594400">Building the ODBC Driver</a>
+ <a href="build_win_sql.html#idp367344">Using the JDBC Driver in ADF/JDeveloper</a>
</span>
</dt>
<dt>
<span class="sect2">
- <a href="build_win_sql.html#idm313808"> Using the ADO.NET Driver
- </a>
+ <a href="build_win_sql.html#idp375344">Building the ODBC Driver</a>
+ </span>
+ </dt>
+ <dt>
+ <span class="sect2">
+ <a href="build_win_sql.html#idp416760"> Using the ADO.NET Driver </a>
</span>
</dt>
</dl>
@@ -181,29 +190,33 @@
</dt>
<dt>
<span class="sect1">
- <a href="build_win_small.html">Building a small memory footprint library</a>
+ <a href="build_win_small.html">Building a small memory
+ footprint library</a>
</span>
</dt>
<dt>
<span class="sect1">
- <a href="build_win_test.html">Running the test suite under Windows</a>
+ <a href="build_win_test.html">Running the test suite under
+ Windows</a>
</span>
</dt>
<dd>
<dl>
<dt>
<span class="sect2">
- <a href="build_win_test.html#idp126120">Building the software needed by the tests</a>
+ <a href="build_win_test.html#idp458352">Building the software needed
+ by the tests</a>
</span>
</dt>
<dt>
<span class="sect2">
- <a href="build_win_test.html#idp137576">Running the test suite under Windows</a>
+ <a href="build_win_test.html#idp389880">Running the test suite under Windows</a>
</span>
</dt>
<dt>
<span class="sect2">
- <a href="build_win_test.html#build_win_test_sql">Building the software needed by the SQL tests</a>
+ <a href="build_win_test.html#build_win_test_sql">Building the software
+ needed by the SQL tests</a>
</span>
</dt>
</dl>
@@ -221,14 +234,16 @@
</dl>
</div>
<p>
- This chapter contains general instructions on building Berkeley DB for specific windows platforms
- using specific compilers. The <a class="xref" href="build_win_faq.html" title="Windows FAQ">Windows FAQ</a>
- also contains helpful information.
-</p>
- <p>
- The <code class="filename">build_windows</code> directory in the Berkeley DB distribution contains
- project files for Microsoft Visual Studio:
-</p>
+ This chapter contains general instructions on building
+ Berkeley DB for specific windows platforms using specific
+ compilers. The <a class="xref" href="build_win_faq.html" title="Windows FAQ">Windows FAQ</a> also contains helpful
+ information.
+ </p>
+ <p>
+ The <code class="filename">build_windows</code> directory in the
+ Berkeley DB distribution contains project files for Microsoft
+ Visual Studio:
+ </p>
<div class="informaltable">
<table border="1" width="80%">
<colgroup>
@@ -237,34 +252,40 @@
</colgroup>
<thead>
<tr>
- <th>Project File</th>
+ <th>Project
+ File</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td align="center">Berkeley_DB.sln</td>
- <td align="center">Visual Studio 2005 (8.0) workspace</td>
+ <td align="center">Visual Studio 2005 (8.0)
+ workspace</td>
</tr>
<tr>
<td align="center">*.vcproj</td>
- <td align="center">Visual Studio 2005 (8.0) projects</td>
+ <td align="center">Visual Studio 2005 (8.0)
+ projects</td>
</tr>
<tr>
<td align="center">Berkeley_DB_vs2010.sln</td>
- <td align="center">Visual Studio 2010 workspace</td>
+ <td align="center">Visual Studio 2010
+ workspace</td>
</tr>
<tr>
<td align="center">*.vcxproj</td>
- <td align="center">Visual Studio 2010 projects</td>
+ <td align="center">Visual Studio 2010
+ projects</td>
</tr>
</tbody>
</table>
</div>
<p>
- These project files can be used to build Berkeley DB for the following platforms: Windows
- NT/2K/XP/2003/Vista and Windows7; and 64-bit Windows XP/2003/Vista and Windows7.
-</p>
+ These project files can be used to build Berkeley DB for
+ Windows Server 2008, Windows Vista, Windows 7, Windows Server
+ 2008 R2, and Windows 8.
+ </p>
<div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
@@ -277,22 +298,27 @@
<dl>
<dt>
<span class="sect2">
- <a href="build_win.html#idm1531520">Visual C++ .NET 2010</a>
+ <a href="build_win.html#idp283736">Visual C++ .NET 2012</a>
</span>
</dt>
<dt>
<span class="sect2">
- <a href="build_win.html#idm232112">Visual C++ .NET 2008</a>
+ <a href="build_win.html#idp270168">Visual C++ .NET 2010</a>
</span>
</dt>
<dt>
<span class="sect2">
- <a href="build_win.html#idm67456">Visual C++ .NET 2005</a>
+ <a href="build_win.html#idp285656">Visual C++ .NET 2008</a>
</span>
</dt>
<dt>
<span class="sect2">
- <a href="build_win.html#idm1085168">Build results</a>
+ <a href="build_win.html#idp292968">Visual C++ .NET 2005</a>
+ </span>
+ </dt>
+ <dt>
+ <span class="sect2">
+ <a href="build_win.html#idp295544">Build results</a>
</span>
</dt>
</dl>
@@ -301,20 +327,40 @@
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a id="idm1531520"></a>Visual C++ .NET 2010</h3>
+ <h3 class="title"><a id="idp283736"></a>Visual C++ .NET 2012</h3>
</div>
</div>
</div>
<div class="orderedlist">
<ol type="1">
- <li>Choose <span class="emphasis"><em>File -&gt; Open -&gt; Project/Solution...</em></span>.
-In the <code class="filename">build_windows</code> directory, select
-<code class="filename">Berkeley_DB_vs2010.sln</code> and click Open.</li>
- <li>Choose the desired project configuration from the drop-down menu on
-the tool bar (either Debug or Release).</li>
- <li>Choose the desired platform configuration from the drop-down menu on
-the tool bar (usually Win32 or x64).</li>
- <li>To build, right-click on the <code class="filename">Berkeley_DB_vs2010</code> solution and select Build Solution.</li>
+ <li>
+ Choose <span class="emphasis"><em>File -&gt; Open -&gt;
+ Project/Solution...</em></span>. In the
+ <code class="filename">build_windows</code> directory,
+ select <code class="filename">Berkeley_DB_vs2010.sln</code>
+ and click Open.
+ </li>
+ <li>
+ The <span class="emphasis"><em>Update VC++ Compiler and Libraries
+ </em></span> dialog box will open automatically.
+ Click <span class="emphasis"><em>Update</em></span> and wait for the
+ projects to be converted.
+ </li>
+ <li>
+ Choose the desired project configuration
+ from the drop-down menu on the tool bar (either
+ Debug or Release).
+ </li>
+ <li>
+ Choose the desired platform configuration
+ from the drop-down menu on the tool bar (usually
+ Win32 or x64).
+ </li>
+ <li>
+ To build, right-click on the
+ <code class="filename">Berkeley_DB_vs2010</code>
+ solution and select Build Solution.
+ </li>
</ol>
</div>
</div>
@@ -322,24 +368,34 @@ the tool bar (usually Win32 or x64).</li>
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a id="idm232112"></a>Visual C++ .NET 2008</h3>
+ <h3 class="title"><a id="idp270168"></a>Visual C++ .NET 2010</h3>
</div>
</div>
</div>
<div class="orderedlist">
<ol type="1">
- <li>Choose <span class="emphasis"><em>File -&gt; Open -&gt; Project/Solution...</em></span>.
-In the <code class="filename">build_windows</code> directory, select
-<code class="filename">Berkeley_DB.sln</code> and click Open.</li>
- <li>The <span class="emphasis"><em>Visual Studio Conversion Wizard</em></span> will open
-automatically. Click the <span class="emphasis"><em>Finish</em></span> button.</li>
- <li>On the next screen click the <span class="emphasis"><em>Close</em></span> button.</li>
- <li>Choose the desired project configuration from the drop-down menu on
-the tool bar (either Debug or Release).</li>
- <li>Choose the desired platform configuration from the drop-down menu on
-the tool bar (usually Win32 or x64).</li>
- <li>To build, right-click on the Berkeley_DB solution and select Build
-Solution.</li>
+ <li>
+ Choose <span class="emphasis"><em>File -&gt; Open -&gt;
+ Project/Solution...</em></span>. In the
+ <code class="filename">build_windows</code> directory,
+ select <code class="filename">Berkeley_DB_vs2010.sln</code>
+ and click Open.
+ </li>
+ <li>
+ Choose the desired project configuration
+ from the drop-down menu on the tool bar (either
+ Debug or Release).
+ </li>
+ <li>
+ Choose the desired platform configuration
+ from the drop-down menu on the tool bar (usually
+ Win32 or x64).
+ </li>
+ <li>
+ To build, right-click on the
+ <code class="filename">Berkeley_DB_vs2010</code>
+ solution and select Build Solution.
+ </li>
</ol>
</div>
</div>
@@ -347,20 +403,43 @@ Solution.</li>
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a id="idm67456"></a>Visual C++ .NET 2005</h3>
+ <h3 class="title"><a id="idp285656"></a>Visual C++ .NET 2008</h3>
</div>
</div>
</div>
<div class="orderedlist">
<ol type="1">
- <li>Choose <span class="emphasis"><em>File -&gt; Open -&gt; Project/Solution...</em></span>.
-In the <code class="filename">build_windows</code> directory, select
-<code class="filename">Berkeley_DB.sln</code> and click Open</li>
- <li>Choose the desired project configuration from the drop-down menu on
-the tool bar (either Debug or Release).</li>
- <li>Choose the desired platform configuration from the drop-down menu on
-the tool bar (usually Win32 or x64).</li>
- <li>To build, right-click on the Berkeley_DB solution and select Build Solution.</li>
+ <li>
+ Choose <span class="emphasis"><em>File -&gt; Open -&gt;
+ Project/Solution...</em></span>. In the
+ <code class="filename">build_windows</code> directory,
+ select <code class="filename">Berkeley_DB.sln</code> and
+ click Open.
+ </li>
+ <li>
+ The <span class="emphasis"><em>Visual Studio Conversion
+ Wizard</em></span> will open automatically.
+ Click the <span class="emphasis"><em>Finish</em></span>
+ button.
+ </li>
+ <li>
+ On the next screen click the
+ <span class="emphasis"><em>Close</em></span> button.
+ </li>
+ <li>
+ Choose the desired project configuration
+ from the drop-down menu on the tool bar (either
+ Debug or Release).
+ </li>
+ <li>
+ Choose the desired platform configuration
+ from the drop-down menu on the tool bar (usually
+ Win32 or x64).
+ </li>
+ <li>
+ To build, right-click on the Berkeley_DB
+ solution and select Build Solution.
+ </li>
</ol>
</div>
</div>
@@ -368,14 +447,48 @@ the tool bar (usually Win32 or x64).</li>
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a id="idm1085168"></a>Build results</h3>
+ <h3 class="title"><a id="idp292968"></a>Visual C++ .NET 2005</h3>
</div>
</div>
</div>
- <p>
- The results of your build will be placed in one of the following
- Berkeley DB subdirectories, depending on the configuration that you chose:
- </p>
+ <div class="orderedlist">
+ <ol type="1">
+ <li>
+ Choose <span class="emphasis"><em>File -&gt; Open -&gt;
+ Project/Solution...</em></span>. In the
+ <code class="filename">build_windows</code> directory,
+ select <code class="filename">Berkeley_DB.sln</code> and
+ click Open
+ </li>
+ <li>
+ Choose the desired project configuration
+ from the drop-down menu on the tool bar (either
+ Debug or Release).
+ </li>
+ <li>
+ Choose the desired platform configuration
+ from the drop-down menu on the tool bar (usually
+ Win32 or x64).
+ </li>
+ <li>
+ To build, right-click on the Berkeley_DB
+ solution and select Build Solution.
+ </li>
+ </ol>
+ </div>
+ </div>
+ <div class="sect2" lang="en" xml:lang="en">
+ <div class="titlepage">
+ <div>
+ <div>
+ <h3 class="title"><a id="idp295544"></a>Build results</h3>
+ </div>
+ </div>
+ </div>
+ <p>
+ The results of your build will be placed in one of
+ the following Berkeley DB subdirectories, depending on
+ the configuration that you chose: </p>
<table class="simplelist" border="0" summary="Simple list">
<tr>
<td>
@@ -399,18 +512,37 @@ the tool bar (usually Win32 or x64).</li>
</tr>
</table>
<p>
- When building your application during development, you should normally
- use compile options "Debug Multithreaded DLL" and link against
- <code class="filename">build_windows\Debug\libdb53d.lib</code>. You can also
- build using a release version of the Berkeley DB libraries and tools,
- which will be placed in
- <code class="filename">build_windows\Win32\Release\libdb53.lib</code>. When
- linking against the release build, you should compile your code with
- the "Release Multithreaded DLL" compile option. You will also need to
- add the <code class="filename">build_windows</code> directory to the list of
- include directories of your application's project, or copy the Berkeley
- DB include files to another location.
- </p>
+ When building your application during
+ development, you should normally use compile options
+ "Debug Multithreaded DLL" and link against
+ <code class="filename">build_windows\Debug\libdb61d.lib</code>.
+ </p>
+ <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
+ <h3 class="title">Note</h3>
+ <p>
+ Building your application with the debug
+ configuration will create a Berkeley DB library
+ and utilities with debugging symbols, as well as
+ load various routines that can be called from a
+ debugger to display pages, cursor queues, and so
+ forth. If installed, the utilities will not be
+ stripped. This configuration should not be
+ specified when building production binaries.
+ </p>
+ </div>
+ <p>
+ You can also build using a release version of the
+ Berkeley DB libraries and tools, which will be placed
+ in
+ <code class="filename">build_windows\Win32\Release\libdb61.lib</code>.
+ When linking against the release build, you should
+ compile your code with the "Release Multithreaded DLL"
+ compile option. You will also need to add the
+ <code class="filename">build_windows</code> directory to
+ the list of include directories of your application's
+ project, or copy the Berkeley DB include files to
+ another location.
+ </p>
</div>
</div>
</div>
@@ -418,12 +550,12 @@ the tool bar (usually Win32 or x64).</li>
<hr />
<table width="100%" summary="Navigation footer">
<tr>
- <td width="40%" align="left"><a accesskey="p" href="build_android_config.html">Prev</a> </td>
+ <td width="40%" align="left"><a accesskey="p" href="build_android_adfmobile.html">Prev</a> </td>
<td width="20%" align="center"> </td>
<td width="40%" align="right"> <a accesskey="n" href="win_build64.html">Next</a></td>
</tr>
<tr>
- <td width="40%" align="left" valign="top">Android Configuration Options </td>
+ <td width="40%" align="left" valign="top">Using the JDBC Driver in ADF Mobile for Android </td>
<td width="20%" align="center">
<a accesskey="h" href="index.html">Home</a>
</td>