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