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 Transaction Processing" /> 10 <link rel="up" href="index.html" title="Getting Started with Berkeley DB Transaction Processing" /> 11 <link rel="prev" href="index.html" title="Getting Started with Berkeley DB Transaction Processing" /> 12 <link rel="next" href="introduction.html" title="Chapter 1. Introduction" /> 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 This document describes how to use transactions with your Berkeley DB 59 applications. It is intended to describe how to 60 transaction protect your application's data. The APIs used to perform this task 61 are described here, as are the environment infrastructure and administrative tasks 62 required by a transactional application. This book also 63 describes multi-threaded <span>and 64 multi-process</span> DB applications and the requirements they 65 have for deadlock detection. 66 </p> 67 <p> 68 This book describes for Berkeley DB version 4.8. 69 </p> 70 <p> 71 This book is aimed at the software engineer responsible for writing a 72 transactional DB application. 73 </p> 74 <p> 75 This book assumes that you have already read and understood the 76 concepts contained in the 77 <span><em class="citetitle">Getting Started with Berkeley DB</em> 78 guide.</span> 79 80 81 </p> 82 <div class="sect1" lang="en" xml:lang="en"> 83 <div class="titlepage"> 84 <div> 85 <div> 86 <h2 class="title" style="clear: both"><a id="conventions"></a>Conventions Used in this Book</h2> 87 </div> 88 </div> 89 </div> 90 <div class="toc"> 91 <dl> 92 <dt> 93 <span class="sect2"> 94 <a href="preface.html#moreinfo">For More Information</a> 95 </span> 96 </dt> 97 </dl> 98 </div> 99 <p> 100 The following typographical conventions are used within in this manual: 101 </p> 102 <p> 103 Class names are represented in <code class="classname">monospaced font</code>, as are <code class="methodname">method 104 names</code>. For example: 105 106 107 108 109 110 <span>"<code class="methodname">DbEnv::open()</code> is a 111 <code class="classname">DbEnv</code> class method."</span> 112 </p> 113 <p> 114 Variable or non-literal text is presented in <span class="emphasis"><em>italics</em></span>. For example: "Go to your 115 <span class="emphasis"><em>DB_INSTALL</em></span> directory." 116 </p> 117 <p> 118 Program examples are displayed in a <code class="classname">monospaced font</code> on a shaded background. 119 For example: 120 </p> 121 <pre class="programlisting">typedef struct vendor { 122 char name[MAXFIELD]; // Vendor name 123 char street[MAXFIELD]; // Street name and number 124 char city[MAXFIELD]; // City 125 char state[3]; // Two-digit US state code 126 char zipcode[6]; // US zipcode 127 char phone_number[13]; // Vendor phone number 128} VENDOR; </pre> 129 <p> 130 In some situations, programming examples are updated from one chapter to the next. When 131 this occurs, the new code is presented in <strong class="userinput"><code>monospaced bold</code></strong> font. For example: 132 </p> 133 <pre class="programlisting">typedef struct vendor { 134 char name[MAXFIELD]; // Vendor name 135 char street[MAXFIELD]; // Street name and number 136 char city[MAXFIELD]; // City 137 char state[3]; // Two-digit US state code 138 char zipcode[6]; // US zipcode 139 char phone_number[13]; // Vendor phone number 140 <strong class="userinput"><code>char sales_rep[MAXFIELD]; // Name of sales representative 141 char sales_rep_phone[MAXFIELD]; // Sales rep's phone number </code></strong> 142} VENDOR; </pre> 143 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"> 144 <h3 class="title">Note</h3> 145 <p> 146 Finally, notes of special interest are represented using a note block such 147 as this. 148 </p> 149 </div> 150 <div class="sect2" lang="en" xml:lang="en"> 151 <div class="titlepage"> 152 <div> 153 <div> 154 <h3 class="title"><a id="moreinfo"></a>For More Information</h3> 155 </div> 156 </div> 157 </div> 158 <p> 159 Beyond this manual, you may also find the following sources of information useful when building a 160 transactional DB application: 161 </p> 162 <div class="itemizedlist"> 163 <ul type="disc"> 164 <li> 165 <p> 166 167 <a class="ulink" href="http://www.oracle.com/technology/documentation/berkeley-db/db/gsg/CXX/index.html" target="_top"> 168 Getting Started with Berkeley DB for C++ 169 </a> 170 171 172 173 174 175 176 </p> 177 </li> 178 <li> 179 <p> 180 181 <a class="ulink" href="http://www.oracle.com/technology/documentation/berkeley-db/db/gsg_db_rep/CXX/index.html" target="_top"> 182 Berkeley DB Getting Started with Replicated Applications for C++ 183 </a> 184 185 </p> 186 </li> 187 <li> 188 <p> 189 <a class="ulink" href="http://www.oracle.com/technology/documentation/berkeley-db/db/programmer_reference/index.html" target="_top"> 190 Berkeley DB Programmer's Reference Guide 191 </a> 192 </p> 193 </li> 194 <li> 195 <p> 196 <span> 197 198 <a class="ulink" href="http://www.oracle.com/technology/documentation/berkeley-db/db/api_reference/CXX/frame_main.html" target="_top"> 199 Berkeley DB C++ API 200 </a> 201 </span> 202 203 204 205 206 207 208 </p> 209 </li> 210 </ul> 211 </div> 212 </div> 213 </div> 214 </div> 215 <div class="navfooter"> 216 <hr /> 217 <table width="100%" summary="Navigation footer"> 218 <tr> 219 <td width="40%" align="left"><a accesskey="p" href="index.html">Prev</a> </td> 220 <td width="20%" align="center"> </td> 221 <td width="40%" align="right"> <a accesskey="n" href="introduction.html">Next</a></td> 222 </tr> 223 <tr> 224 <td width="40%" align="left" valign="top">Getting Started with Berkeley DB Transaction Processing </td> 225 <td width="20%" align="center"> 226 <a accesskey="h" href="index.html">Home</a> 227 </td> 228 <td width="40%" align="right" valign="top"> Chapter 1. Introduction</td> 229 </tr> 230 </table> 231 </div> 232 </body> 233</html> 234