Chapter 1. Introduction to Porting Berkeley DB

Table of Contents

Types of Berkeley DB ports
When Oracle Has Agreed to Support Berkeley DB on the New Platform
When Oracle has Not Agreed to Support Berkeley DB on the New Platform
Berkeley DB Porting Process

Berkeley DB is an open source database product that supports a variety of platforms. When there is a need to run Berkeley DB on a platform that is currently not supported, DB is distributed in source code form that you can use as base source to port Berkeley DB to that platform.

Before you begin actually porting Berkeley DB, you need an understanding of the:

Types of Berkeley DB ports

There are several types of Berkeley DB ports:

  • Ports developed and supported by Oracle

  • Ports developed by a customer or a partner, but which Oracle has agreed to support.

  • Ports developed, maintained, and supported by a customer or partner.

For a port developed by a customer or a partner, the general steps for porting Berkeley DB to a new platform are the same whether or not Oracle has agreed to support Berkeley DB on the new platform. For example, after you complete the port you send it to Berkeley DB as described in Integrating Changes into the Berkeley DB Source Code. However, there are some differences.

When Oracle Has Agreed to Support Berkeley DB on the New Platform

When porting Berkeley DB to a platform that Oracle has agreed to support, you need to have Berkeley DB engineering review your port at various points. These review points are discussed more fully in Integrating Changes into the Berkeley DB Source Code, Modifying the Tests, and Reviewing the Results of the Tests.

It is up to you to submit the results of the tests (test_micro, test_os, test_mutex, and, if possible, the entire tcl test suit) for review by Oracle Berkelely DB engineering in order for Oracle to consider providing support for Berkeley DB on a new platform.

You must also assign copyrights for your changes to any part of Berkeley DB to "Oracle Corporation" and attest to the fact that you are not infringing on any software patents for the changes to be included in the general Berekely DB distribution.

Once the port is certified, Oracle provides support for Berkeley DB on the new platform in the same manner that it does for Berkeley DB running on other established platforms.

When Oracle has Not Agreed to Support Berkeley DB on the New Platform

When Oracle has not agreed to support Berkeley DB on the new platform, the customer or partner assume the responsibility of front-line support. When it is determined that there is a problem in the code that was not modified by the customer or partner, then Berkeley DB engineering provides support to the customer or vendor who implemented the port, However, in these cases, Oracle needs access to the platform and hardware for diagnosing, debugging, and testing.