preface.html   [plain text]


<?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>Preface</title>
    <link rel="stylesheet" href="gettingStarted.css" type="text/css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.62.4" />
    <link rel="home" href="index.html" title="Porting Berkeley DB" />
    <link rel="up" href="index.html" title="Porting Berkeley DB" />
    <link rel="previous" href="index.html" title="Porting Berkeley DB" />
    <link rel="next" href="introduction.html" title="Chapter 1. Introduction to Porting Berkeley DB " />
  </head>
  <body>
    <div class="navheader">
      <table width="100%" summary="Navigation header">
        <tr>
          <th colspan="3" align="center">Preface</th>
        </tr>
        <tr>
          <td width="20%" align="left"><a accesskey="p" href="index.html">Prev</a> </td>
          <th width="60%" align="center"> </th>
          <td width="20%" align="right"> <a accesskey="n" href="introduction.html">Next</a></td>
        </tr>
      </table>
      <hr />
    </div>
    <div class="preface" lang="en" xml:lang="en">
      <div class="titlepage">
        <div>
          <div>
            <h2 class="title"><a id="preface"></a>Preface</h2>
          </div>
        </div>
        <div></div>
      </div>
      <div class="toc">
        <p>
          <b>Table of Contents</b>
        </p>
        <dl>
          <dt>
            <span class="sect1">
              <a href="preface.html#conventions">Conventions Used in this Book</a>
            </span>
          </dt>
          <dd>
            <dl>
              <dt>
                <span class="sect2">
                  <a href="preface.html#audience">Audience</a>
                </span>
              </dt>
              <dt>
                <span class="sect2">
                  <a href="preface.html#moreinfo">For More Information</a>
                </span>
              </dt>
            </dl>
          </dd>
        </dl>
      </div>
      <p>
        The Berkeley DB  family of open source, embeddable databases
        provides developers with fast, reliable persistence with zero
        administration. Often deployed as "edge" databases, the Berkeley DB
        family provides very high performance, reliability, scalability,
        and availability for application use cases that do not require SQL.
</p>
      <p>
        As an open source database, Berkeley DB works on many different
        platforms, from Wind River's Tornado system, to VMS, to
        Windows NT and Windows 95, and most existing UNIX
        platforms. It runs on 32 and 64-bit machines, little or big-endian.
</p>
      <p>
        <span class="emphasis"><em>Berkeley DB Porting Guide</em></span> provides the information you need to
        port Berkeley DB to additional platforms.
</p>
      <div class="sect1" lang="en" xml:lang="en">
        <div class="titlepage">
          <div>
            <div>
              <h2 class="title" style="clear: both"><a id="conventions"></a>Conventions Used in this Book</h2>
            </div>
          </div>
          <div></div>
        </div>
        <p>
        The following typographical conventions are used within in this manual:
    </p>
        <p>
        Structure names are represented in <tt class="classname">monospaced font</tt>, as are <tt class="methodname">method
        names</tt>. For example: "<tt class="methodname">DB-&gt;open()</tt> is a method
		on a <tt class="classname">DB</tt> handle."
    </p>
        <p>
        Variable or non-literal text is presented in <span class="emphasis"><em>italics</em></span>. For example: "Go to your
        <span class="emphasis"><em>DB_INSTALL</em></span> 
        directory."
    </p>
        <p>
        Program examples are displayed in a <tt class="classname">monospaced font</tt> on a shaded background.
        For example:
    </p>
        <pre class="programlisting">/* File: gettingstarted_common.h */
typedef struct stock_dbs {
    DB *inventory_dbp; /* Database containing inventory information */
    DB *vendor_dbp;    /* Database containing vendor information */

    char *db_home_dir;       /* Directory containing the database files */
    char *inventory_db_name; /* Name of the inventory database */
    char *vendor_db_name;    /* Name of the vendor database */
} STOCK_DBS; </pre>
        <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
          <h3 class="title">Note</h3>
          <p>
            Finally, notes of interest are represented using a note block such
            as this.
        </p>
        </div>
        <div class="sect2" lang="en" xml:lang="en">
          <div class="titlepage">
            <div>
              <div>
                <h3 class="title"><a id="audience"></a>Audience</h3>
              </div>
            </div>
            <div></div>
          </div>
          <p>
                This guide is intended
                for programmers porting Berkeley DB to a new platform. It
                assumes that these programmers possess:
        </p>
          <div class="itemizedlist">
            <ul type="disc">
              <li>
                <p>
                    Familiarity with standard ANSI C and POSIX C 1003.1 and 1003.2 library and system
                    calls.
                </p>
              </li>
              <li>
                <p>
                            
                            Working knowledge of the target platform as well as the development tools (for example, compilers, linkers, and debuggers) available on that platform.
                    </p>
              </li>
            </ul>
          </div>
        </div>
        <div class="sect2" lang="en" xml:lang="en">
          <div class="titlepage">
            <div>
              <div>
                <h3 class="title"><a id="moreinfo"></a>For More Information</h3>
              </div>
            </div>
            <div></div>
          </div>
          <p>
            Beyond this manual, you may also find the following sources of information useful when building a
            DB application:
        </p>
          <div class="itemizedlist">
            <ul type="disc">
              <li>
                <p>
                    <a href="http://www.oracle.com/technology/documentation/berkeley-db/db/gsg/C/index.html" target="_top">
                        Getting Started with Berkeley DB for C
                    </a>
                    </p>
              </li>
              <li>
                <p>
                    <a href="http://www.oracle.com/technology/documentation/berkeley-db/db/gsg_txn/C/index.html" target="_top">
                        Getting Started with Transaction Processing for C
                    </a>
                </p>
              </li>
              <li>
                <p>
                        <a href="http://www.oracle.com/technology/documentation/berkeley-db/db/gsg_db_rep/C/index.html" target="_top">
                                Berkeley DB Getting Started with Replicated Applications for C
                        </a>
                </p>
              </li>
              <li>
                <p>
                    <a href="http://www.oracle.com/technology/documentation/berkeley-db/db/ref/toc.html" target="_top">
                        Berkeley DB Programmer's Reference Guide
                    </a>
                </p>
              </li>
              <li>
                <p>
                    <a href="http://www.oracle.com/technology/documentation/berkeley-db/db/api_c/frame.html" target="_top">
                        Berkeley DB C API
                    </a>
                </p>
              </li>
            </ul>
          </div>
        </div>
      </div>
    </div>
    <div class="navfooter">
      <hr />
      <table width="100%" summary="Navigation footer">
        <tr>
          <td width="40%" align="left"><a accesskey="p" href="index.html">Prev</a> </td>
          <td width="20%" align="center">
            <a accesskey="u" href="index.html">Up</a>
          </td>
          <td width="40%" align="right"> <a accesskey="n" href="introduction.html">Next</a></td>
        </tr>
        <tr>
          <td width="40%" align="left" valign="top">Porting Berkeley DB </td>
          <td width="20%" align="center">
            <a accesskey="h" href="index.html">Home</a>
          </td>
          <td width="40%" align="right" valign="top"> Chapter 1. Introduction to Porting Berkeley DB </td>
        </tr>
      </table>
    </div>
  </body>
</html>