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="Getting Started with Berkeley DB" /> 10 <link rel="up" href="index.html" title="Getting Started with Berkeley DB" /> 11 <link rel="prev" href="index.html" title="Getting Started with Berkeley DB" /> 12 <link rel="next" href="introduction.html" title="Chapter 1. Introduction to 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#moreinfo">For More Information</a> 51 </span> 52 </dt> 53 </dl> 54 </dd> 55 </dl> 56 </div> 57 <p> 58 Welcome to Berkeley DB (DB). This document introduces 59 60 <span>DB, version 4.8. </span> 61 It is intended 62 to provide a rapid introduction to the DB API set and related concepts. The goal of this document is 63 to provide you with an efficient mechanism 64 with which you can evaluate DB against your project's technical requirements. As such, this document is 65 intended for 66 67 <span>C</span> developers and senior software architects who are 68 looking for an 69 <span> 70 in-process data management solution. 71 </span> 72 73 No prior experience with Berkeley DB is expected or required. 74 </p> 75 <div class="sect1" lang="en" xml:lang="en"> 76 <div class="titlepage"> 77 <div> 78 <div> 79 <h2 class="title" style="clear: both"><a id="conventions"></a>Conventions Used in this Book</h2> 80 </div> 81 </div> 82 </div> 83 <div class="toc"> 84 <dl> 85 <dt> 86 <span class="sect2"> 87 <a href="preface.html#moreinfo">For More Information</a> 88 </span> 89 </dt> 90 </dl> 91 </div> 92 <p> 93 The following typographical conventions are used within in this manual: 94 </p> 95 <p> 96 Structure names are represented in <code class="classname">monospaced font</code>, as are <code class="methodname">method 97 names</code>. For example: "<code class="methodname">DB->open()</code> is a method 98 on a <code class="classname">DB</code> handle." 99 </p> 100 <p> 101 Variable or non-literal text is presented in <span class="emphasis"><em>italics</em></span>. For example: "Go to your 102 103 <span class="emphasis"><em>DB_INSTALL</em></span> 104 105 directory." 106 </p> 107 <p> 108 Program examples are displayed in a <code class="classname">monospaced font</code> on a shaded background. 109 For example: 110 </p> 111 <pre class="programlisting">/* File: gettingstarted_common.h */ 112typedef struct stock_dbs { 113 DB *inventory_dbp; /* Database containing inventory information */ 114 DB *vendor_dbp; /* Database containing vendor information */ 115 116 char *db_home_dir; /* Directory containing the database files */ 117 char *inventory_db_name; /* Name of the inventory database */ 118 char *vendor_db_name; /* Name of the vendor database */ 119} STOCK_DBS; </pre> 120 <p> 121 In some situations, programming examples are updated from one chapter to the next. When 122 this occurs, the new code is presented in <strong class="userinput"><code>monospaced bold</code></strong> font. For example: 123 </p> 124 <pre class="programlisting">typedef struct stock_dbs { 125 DB *inventory_dbp; /* Database containing inventory information */ 126 DB *vendor_dbp; /* Database containing vendor information */ 127 <strong class="userinput"><code>DB *itemname_sdbp; /* Index based on the item name index */</code></strong> 128 char *db_home_dir; /* Directory containing the database files */ 129 <strong class="userinput"><code>char *itemname_db_name; /* Itemname secondary database */</code></strong> 130 char *inventory_db_name; /* Name of the inventory database */ 131 char *vendor_db_name; /* Name of the vendor database */ 132} STOCK_DBS; </pre> 133 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"> 134 <h3 class="title">Note</h3> 135 <p> 136 Finally, notes of interest are represented using a note block such 137 as this. 138 </p> 139 </div> 140 <div class="sect2" lang="en" xml:lang="en"> 141 <div class="titlepage"> 142 <div> 143 <div> 144 <h3 class="title"><a id="moreinfo"></a>For More Information</h3> 145 </div> 146 </div> 147 </div> 148 <p> 149 Beyond this manual, you may also find the following sources of information useful when building a 150 DB application: 151 </p> 152 <div class="itemizedlist"> 153 <ul type="disc"> 154 <li> 155 <p> 156 157 158 <a class="ulink" href="http://www.oracle.com/technology/documentation/berkeley-db/db/gsg_txn/C/index.html" target="_top"> 159 Getting Started with Transaction Processing for C 160 </a> 161 162 163 164 165 </p> 166 </li> 167 <li> 168 <p> 169 <a class="ulink" href="http://www.oracle.com/technology/documentation/berkeley-db/db/gsg_db_rep/C/index.html" target="_top"> 170 Berkeley DB Getting Started with Replicated Applications for C 171 </a> 172 173 174 </p> 175 </li> 176 <li> 177 <p> 178 <a class="ulink" href="http://www.oracle.com/technology/documentation/berkeley-db/db/programmer_reference/index.html" target="_top"> 179 Berkeley DB Programmer's Reference Guide 180 </a> 181 </p> 182 </li> 183 <li> 184 <p> 185 <span> 186 <a class="ulink" href="http://www.oracle.com/technology/documentation/berkeley-db/db/api_reference/C/frame_main.html" target="_top"> 187 Berkeley DB C API 188 </a> 189 190 </span> 191 192 193 194 195 196 197 198 </p> 199 </li> 200 </ul> 201 </div> 202 </div> 203 </div> 204 </div> 205 <div class="navfooter"> 206 <hr /> 207 <table width="100%" summary="Navigation footer"> 208 <tr> 209 <td width="40%" align="left"><a accesskey="p" href="index.html">Prev</a> </td> 210 <td width="20%" align="center"> </td> 211 <td width="40%" align="right"> <a accesskey="n" href="introduction.html">Next</a></td> 212 </tr> 213 <tr> 214 <td width="40%" align="left" valign="top">Getting Started with Berkeley DB </td> 215 <td width="20%" align="center"> 216 <a accesskey="h" href="index.html">Home</a> 217 </td> 218 <td width="40%" align="right" valign="top"> Chapter 1. Introduction to Berkeley DB </td> 219 </tr> 220 </table> 221 </div> 222 </body> 223</html> 224