Oracle Berkeley DB Installation and Build Guide 11g Release 2 Library Version 11.2.5.3 Legal Notice Published 9/9/2013 Table of Contents Preface ....................................................................................................... x Conventions Used in this Book .................................................................... x For More Information ............................................................................... x Contact Us ...................................................................................... x 1. Introduction .............................................................................................. 1 Installation Overview ................................................................................ 1 Supported Platforms ................................................................................ 1 2. System Installation Notes ............................................................................ 3 File utility /etc/magic information ............................................................... 3 Magic information ............................................................................. 3 Big-endian magic information ............................................................... 4 Little-endian magic information ............................................................ 7 Building with multiple versions of Berkeley DB ................................................ 9 3. Debugging Applications .............................................................................. 11 Introduction to debugging ........................................................................ 11 Compile-time configuration ...................................................................... 11 Run-time error information ....................................................................... 12 Reviewing Berkeley DB log files ................................................................. 12 Augmenting the Log for Debugging ....................................................... 16 Extracting Committed Transactions and Transaction Status ........................... 16 Extracting Transaction Histories ........................................................... 16 Extracting File Histories .................................................................... 16 Extracting Page Histories ................................................................... 16 Other log processing tools ................................................................. 17 4. Building Berkeley DB for Android ................................................................... 18 Building the Drop-In Replacement for Android ................................................ 18 Migrating from SQLite to Berkeley DB ................................................... 19 Building the Android JDBC Driver ............................................................... 20 Android Configuration Options ................................................................... 25 5. Building Berkeley DB for Windows ................................................................ 26 Building Berkeley DB for 32 bit Windows ...................................................... 26 Visual C++ .NET 2010 ........................................................................ 26 Visual C++ .NET 2008 ........................................................................ 26 Visual C++ .NET 2005 ........................................................................ 27 Build results .................................................................................. 27 Building Berkeley DB for 64-bit Windows ...................................................... 27 x64 build with Visual Studio 2005 or newer ............................................. 27 Building Berkeley DB with Cygwin ............................................................... 28 Building the C++ API ............................................................................... 28 Building the C++ STL API ......................................................................... 28 Building the Java API .............................................................................. 28 Building the C# API ................................................................................ 29 Building the SQL API ............................................................................... 29 Binary Compatibility With SQLite ......................................................... 30 Setting Preprocessor Flags ................................................................ 30 Enabling Extensions ......................................................................... 30 9/9/2013 DB Installation Guide Page iii Disabling Log Checksums ................................................................... 30 Building the JDBC Driver ................................................................... 31 Using the JDBC Driver ...................................................................... 31 Downloading JDBC Sample Code .................................................... 32 Modifying Sample Code .............................................................. 32 Building and Running the JDBC Sample code ..................................... 32 Building the ODBC Driver ................................................................... 33 Configuring Your System ............................................................. 33 Building the Library ................................................................... 33 Installing the Library ................................................................. 34 Testing the ODBC Install ............................................................. 34 Using the ADO.NET Driver ................................................................ 34 Building the Tcl API ................................................................................ 34 Distributing DLLs ................................................................................... 35 Additional build options ........................................................................... 36 Building a small memory footprint library ..................................................... 36 Running the test suite under Windows ......................................................... 37 Building the software needed by the tests .............................................. 37 Visual Studio 2005 or newer ........................................................ 37 Running the test suite under Windows ................................................... 37 Building the software needed by the SQL tests ........................................ 38 Visual Studio 2005 or newer ........................................................ 38 Windows notes ...................................................................................... 39 Windows FAQ ........................................................................................ 39 6. Building Berkeley DB for Windows Mobile ........................................................ 42 Building for Windows Mobile ..................................................................... 42 Building Berkeley DB for Windows Mobile ............................................... 42 Visual Studio 2005 .................................................................... 42 Build results ............................................................................ 42 Changing Build Configuration Type ....................................................... 42 Building Berkeley DB for different target platforms ................................... 43 Visual Studio 2005 .................................................................... 43 BDB SQL Notes ......................................................................... 44 Windows Mobile notes ............................................................................. 44 Windows Mobile FAQ ............................................................................... 44 7. Building Berkeley DB for UNIX/POSIX ............................................................. 47 Building for UNIX/POSIX ........................................................................... 47 Building the Berkeley DB SQL Interface .................................................. 47 Configuring Berkeley DB .......................................................................... 48 Configuring the SQL Interface ................................................................... 54 Changing Compile Options ................................................................. 55 Enabling Extensions ......................................................................... 56 Building the JDBC Driver ................................................................... 57 Using the JDBC Driver ...................................................................... 57 Downloading JDBC Sample Code .................................................... 57 Modifying Sample Code .............................................................. 57 Building and Running the JDBC Sample code ..................................... 58 Building the ODBC Driver ................................................................... 58 Configuring Your System ............................................................. 58 9/9/2013 DB Installation Guide Page iv Building the Library ................................................................... 59 Testing the ODBC Driver ............................................................