Berkeley DB Installation and Build Guide

Legal Notice

This documentation is distributed under an open source license. You may review the terms of this license at: http://download.oracle.com/docs/cd/E17076_02/html/license/license_db.html

Oracle, Berkeley DB, and Sleepycat are trademarks or registered trademarks of Oracle. All rights to these marks are reserved. No third-party use is permitted without the express prior written consent of Oracle.

Other names may be trademarks of their respective owners.

To obtain a copy of this document's original source code, please submit a request to the Oracle Technology Network forum at: http://forums.oracle.com/forums/forum.jspa?forumID=271

8/27/2010


Table of Contents

Preface
Conventions Used in this Book
For More Information
Contact Us
1. Introduction
Installation Overview
2. System Installation Notes
File utility /etc/magic information
Magic information
Big-endian magic information
Little-endian magic information
Building with multiple versions of Berkeley DB
3. Debugging Applications
Introduction to debugging
Compile-time configuration
Run-time error information
Reviewing Berkeley DB log files
Augmenting the Log for Debugging
Extracting Committed Transactions and Transaction Status
Extracting Transaction Histories
Extracting File Histories
Extracting Page Histories
Other log processing tools
4. Building Berkeley DB for Windows
Building Berkeley DB for 32 bit Windows
Visual C++ .NET 2010
Visual C++ .NET 2008
Visual C++ .NET 2005
Build results
Building Berkeley DB for 64-bit Windows
x64 build with Visual Studio 2005 or newer
Building Berkeley DB with Cygwin
Building the C++ API
Building the C++ STL API
Building the Java API
Building the C# API
Building the SQL API
Binary Compatibility With SQLite
Setting Preprocessor Flags
Enabling Extensions
Building the JDBC Driver
Using the JDBC Driver
Building the ODBC Driver
Using the ADO.NET Driver
Building the Tcl API
Distributing DLLs
Building a small memory footprint library
Running the test suite under Windows
Building the software needed by the tests
Running the test suite under Windows
Building the software needed by the SQL tests
Windows notes
Windows FAQ
5. Building Berkeley DB for Windows Mobile
Building for Windows Mobile
Building Berkeley DB for Windows Mobile
Changing Build Configuration Type
Building Berkeley DB for different target platforms
Windows Mobile notes
Windows Mobile FAQ
6. Building Berkeley DB for UNIX/POSIX
Building for UNIX/POSIX
Building the Berkeley DB SQL Interface
Configuring Berkeley DB
Configuring the SQL Interface
Changing Compile Options
Enabling Extensions
Building the JDBC Driver
Using the JDBC Driver
Building the ODBC Driver
Building a small memory footprint library
Changing compile or load options
Installing Berkeley DB
Dynamic shared libraries
Running the test suite under UNIX
Building SQL Test Suite on Unix
Architecture independent FAQ
AIX
FreeBSD
HP-UX
iPhone OS
IRIX
Linux
Mac OS X
OSF/1
QNX
SCO
Solaris
SunOS
Ultrix
7. Building Berkeley DB for VxWorks
Building for VxWorks 5.4 and 5.5
Building With Tornado 2.0 or Tornado 2.2
Building for VxWorks 6.x
Building With Wind River Workbench using the Makefile
VxWorks notes
Building and Running the Demo Program
Building and Running the Utility Programs
VxWorks 5.4/5.5: shared memory
VxWorks 5.4/5.5: building a small memory footprint library
Support for Replication Manager
VxWorks FAQ
8. Upgrading Berkeley DB 11.2.5.0 applications to Berkeley DB 11.2.5.1
Introduction
DPL Applications must be recompiled
Source Tree Rearranged
SQLite Interface Upgrade
Mod_db4 Support Discontinued
Berkeley DB Library Version 11.2.5.1 ChangeLog
Database or Log File On-Disk Format Changes
New Features
Database Environment Changes
Access Method Changes
API Changes
SQL-Specific API Changes
Tcl-Specific API Changes
Java-Specific API Changes
C#-Specific API Changes
Direct Persistence Layer (DPL), Bindings and Collections API
Replication Changes
Locking Subsystem Changes
Memory Pool Subsystem Changes
Mutex Subsystem Changes
Transaction Subsystem Changes
Utility Changes
Configuration, Documentation, Sample Apps, Portability, and Build Changes
Example Changes
Miscellaneous Bug Fixes
Deprecated Features
Known Bugs
9. Upgrading Berkeley DB 4.8 applications to Berkeley DB 11.2.5.0
Introduction
db_sql Renamed to db_sql_codegen
DB_REP_CONF_NOAUTOINIT Replaced
Support for Multiple Client-to-Client Peers
Cryptography Support
DB_NOSYNC Flag to Flush Files
Dropped Support
Changing Stack Size
Berkeley DB 11g Release 2 Change Log
Database or Log File On-Disk Format Changes
New Features
Database Environment Changes
Access Method Changes
Locking Subsystem Changes
Logging Subsystem Changes
Memory Pool Subsystem Changes
Mutex Subsystem Changes
Tcl-specific API Changes
C#-specific API Changes
API Changes
Replication Changes
Transaction Subsystem Changes
Utility Changes
Example Changes
Deprecated Features
Configuration, Documentation, Sample Apps, Portability and Build Changes
Known Bugs
10. Upgrading Berkeley DB 4.7 applications to Berkeley DB 4.8
Introduction
Registering DPL Secondary Keys
Minor Change in Behavior of DB_MPOOLFILE->get
Dropped Support for fcntl System Calls
Upgrade Requirements
Berkeley DB 4.8.28 Change Log
Changes between 4.8.26 and 4.8.28:
Known bugs in 4.8
Changes between 4.8.24 and 4.8.26:
Changes between 4.8.21 and 4.8.24:
Changes between 4.7 and 4.8.21:
Database or Log File On-Disk Format Changes:
New Features:
Database Environment Changes:
Concurrent Data Store Changes:
General Access Method Changes:
Btree Access Method Changes:
Hash Access Method Changes:
Queue Access Method Changes:
Recno Access Method Changes:
C-specific API Changes:
C++-specific API Changes:
Java-specific API Changes:
Direct Persistence Layer (DPL), Bindings and Collections API:
Tcl-specific API Changes:
RPC-specific Client/Server Changes:
Replication Changes:
XA Resource Manager Changes:
Locking Subsystem Changes:
Logging Subsystem Changes:
Memory Pool Subsystem Changes:
Mutex Subsystem Changes:
Test Suite Changes
Transaction Subsystem Changes:
Utility Changes:
Configuration, Documentation, Sample Application, Portability and Build Changes:
11. Test Suite
Running the test suite
Running SQL Test Suite on Unix
Running SQL Test Suite on Windows
Test suite FAQ