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