1<?xml version="1.0" encoding="UTF-8" standalone="no"?>
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml">
4  <head>
5    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
6    <title>Preface</title>
7    <link rel="stylesheet" href="gettingStarted.css" type="text/css" />
8    <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" />
9    <link rel="start" href="index.html" title="Porting Berkeley DB" />
10    <link rel="up" href="index.html" title="Porting Berkeley DB" />
11    <link rel="prev" href="index.html" title="Porting Berkeley DB" />
12    <link rel="next" href="introduction.html" title="Chapter 1. Introduction to Porting Berkeley DB" />
13  </head>
14  <body>
15    <div class="navheader">
16      <table width="100%" summary="Navigation header">
17        <tr>
18          <th colspan="3" align="center">Preface</th>
19        </tr>
20        <tr>
21          <td width="20%" align="left"><a accesskey="p" href="index.html">Prev</a> </td>
22          <th width="60%" align="center"> </th>
23          <td width="20%" align="right"> <a accesskey="n" href="introduction.html">Next</a></td>
24        </tr>
25      </table>
26      <hr />
27    </div>
28    <div class="preface" lang="en" xml:lang="en">
29      <div class="titlepage">
30        <div>
31          <div>
32            <h2 class="title"><a id="preface"></a>Preface</h2>
33          </div>
34        </div>
35      </div>
36      <div class="toc">
37        <p>
38          <b>Table of Contents</b>
39        </p>
40        <dl>
41          <dt>
42            <span class="sect1">
43              <a href="preface.html#conventions">Conventions Used in this Book</a>
44            </span>
45          </dt>
46          <dd>
47            <dl>
48              <dt>
49                <span class="sect2">
50                  <a href="preface.html#audience">Audience</a>
51                </span>
52              </dt>
53              <dt>
54                <span class="sect2">
55                  <a href="preface.html#moreinfo">For More Information</a>
56                </span>
57              </dt>
58            </dl>
59          </dd>
60        </dl>
61      </div>
62      <p>
63        The Berkeley DB  family of open source, embeddable databases
64        provides developers with fast, reliable persistence with zero
65        administration. Often deployed as "edge" databases, the Berkeley DB
66        family provides very high performance, reliability, scalability,
67        and availability for application use cases that do not require SQL.
68</p>
69      <p>
70        As an open source database, Berkeley DB works on many different
71        platforms, from Wind River's Tornado system, to VMS, to
72        Windows NT and Windows 95, and most existing UNIX
73        platforms. It runs on 32 and 64-bit machines, little or big-endian.
74</p>
75      <p>
76        <span class="emphasis"><em>Berkeley DB Porting Guide</em></span> provides the information you need to
77        port Berkeley DB to additional platforms.
78</p>
79      <div class="sect1" lang="en" xml:lang="en">
80        <div class="titlepage">
81          <div>
82            <div>
83              <h2 class="title" style="clear: both"><a id="conventions"></a>Conventions Used in this Book</h2>
84            </div>
85          </div>
86        </div>
87        <div class="toc">
88          <dl>
89            <dt>
90              <span class="sect2">
91                <a href="preface.html#audience">Audience</a>
92              </span>
93            </dt>
94            <dt>
95              <span class="sect2">
96                <a href="preface.html#moreinfo">For More Information</a>
97              </span>
98            </dt>
99          </dl>
100        </div>
101        <p>
102        The following typographical conventions are used within in this manual:
103    </p>
104        <p>
105        Structure names are represented in <code class="classname">monospaced font</code>, as are <code class="methodname">method
106        names</code>. For example: "<code class="methodname">DB-&gt;open()</code> is a method
107		on a <code class="classname">DB</code> handle."
108    </p>
109        <p>
110        Variable or non-literal text is presented in <span class="emphasis"><em>italics</em></span>. For example: "Go to your
111        <span class="emphasis"><em>DB_INSTALL</em></span> 
112        directory."
113    </p>
114        <p>
115        Program examples are displayed in a <code class="classname">monospaced font</code> on a shaded background.
116        For example:
117    </p>
118        <pre class="programlisting">/* File: gettingstarted_common.h */
119typedef struct stock_dbs {
120    DB *inventory_dbp; /* Database containing inventory information */
121    DB *vendor_dbp;    /* Database containing vendor information */
122
123    char *db_home_dir;       /* Directory containing the database files */
124    char *inventory_db_name; /* Name of the inventory database */
125    char *vendor_db_name;    /* Name of the vendor database */
126} STOCK_DBS; </pre>
127        <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
128          <h3 class="title">Note</h3>
129          <p>
130            Finally, notes of interest are represented using a note block such
131            as this.
132        </p>
133        </div>
134        <div class="sect2" lang="en" xml:lang="en">
135          <div class="titlepage">
136            <div>
137              <div>
138                <h3 class="title"><a id="audience"></a>Audience</h3>
139              </div>
140            </div>
141          </div>
142          <p>
143                This guide is intended
144                for programmers porting Berkeley DB to a new platform. It
145                assumes that these programmers possess:
146        </p>
147          <div class="itemizedlist">
148            <ul type="disc">
149              <li>
150                <p>
151                    Familiarity with standard ANSI C and POSIX C 1003.1 and 1003.2 library and system
152                    calls.
153                </p>
154              </li>
155              <li>
156                <p>
157                            
158                            Working knowledge of the target platform as well as the development tools (for example, compilers, linkers, and debuggers) available on that platform.
159                    </p>
160              </li>
161            </ul>
162          </div>
163        </div>
164        <div class="sect2" lang="en" xml:lang="en">
165          <div class="titlepage">
166            <div>
167              <div>
168                <h3 class="title"><a id="moreinfo"></a>For More Information</h3>
169              </div>
170            </div>
171          </div>
172          <p>
173            Beyond this manual, you may also find the following sources of information useful when building a
174            DB application:
175        </p>
176          <div class="itemizedlist">
177            <ul type="disc">
178              <li>
179                <p>
180                    <a class="ulink" href="http://www.oracle.com/technology/documentation/berkeley-db/db/gsg/C/index.html" target="_top">
181                        Getting Started with Berkeley DB for C
182                    </a>
183                    </p>
184              </li>
185              <li>
186                <p>
187                    <a class="ulink" href="http://www.oracle.com/technology/documentation/berkeley-db/db/gsg_txn/C/index.html" target="_top">
188                        Getting Started with Transaction Processing for C
189                    </a>
190                </p>
191              </li>
192              <li>
193                <p>
194                        <a class="ulink" href="http://www.oracle.com/technology/documentation/berkeley-db/db/gsg_db_rep/C/index.html" target="_top">
195                                Berkeley DB Getting Started with Replicated Applications for C
196                        </a>
197                </p>
198              </li>
199              <li>
200                <p>
201                    <a class="ulink" href="http://www.oracle.com/technology/documentation/berkeley-db/db/programmer_reference/index.html" target="_top">
202                        Berkeley DB Programmer's Reference Guide
203                    </a>
204                </p>
205              </li>
206              <li>
207                <p>
208                    <a class="ulink" href="http://www.oracle.com/technology/documentation/berkeley-db/db/api_reference/C/frame_main.html" target="_top">
209                        Berkeley DB C API
210                    </a>
211                </p>
212              </li>
213            </ul>
214          </div>
215        </div>
216      </div>
217    </div>
218    <div class="navfooter">
219      <hr />
220      <table width="100%" summary="Navigation footer">
221        <tr>
222          <td width="40%" align="left"><a accesskey="p" href="index.html">Prev</a> </td>
223          <td width="20%" align="center"> </td>
224          <td width="40%" align="right"> <a accesskey="n" href="introduction.html">Next</a></td>
225        </tr>
226        <tr>
227          <td width="40%" align="left" valign="top">Porting Berkeley DB </td>
228          <td width="20%" align="center">
229            <a accesskey="h" href="index.html">Home</a>
230          </td>
231          <td width="40%" align="right" valign="top"> Chapter 1. Introduction to Porting Berkeley DB </td>
232        </tr>
233      </table>
234    </div>
235  </body>
236</html>
237