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 Replicated Berkeley DB Applications" /> 10 <link rel="up" href="index.html" title="Getting Started with Replicated Berkeley DB Applications" /> 11 <link rel="prev" 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> 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 write replicated Berkeley DB applications for Berkeley DB version 4.8. 59 The APIs used to implement replication in your application 60 are described here. This book describes the concepts surrounding replication, the scenarios under which you 61 might choose to use it, and the architectural requirements that a replication application has over a 62 transactional application. 63 </p> 64 <p> 65 This book is aimed at the software engineer responsible for writing a 66 replicated DB application. 67 </p> 68 <p> 69 This book assumes that you have already read and understood the 70 concepts contained in the 71 <span><em class="citetitle">Berkeley DB Getting Started with Transaction Processing</em> guide.</span> 72 73 </p> 74 <div class="sect1" lang="en" xml:lang="en"> 75 <div class="titlepage"> 76 <div> 77 <div> 78 <h2 class="title" style="clear: both"><a id="conventions"></a>Conventions Used in this Book</h2> 79 </div> 80 </div> 81 </div> 82 <div class="toc"> 83 <dl> 84 <dt> 85 <span class="sect2"> 86 <a href="preface.html#moreinfo">For More Information</a> 87 </span> 88 </dt> 89 </dl> 90 </div> 91 <p> 92 The following typographical conventions are used within in this manual: 93 </p> 94 <p> 95 Structure names are represented in <code class="classname">monospaced font</code>, as are <code class="methodname">method 96 names</code>. For example: "<code class="methodname">DB->open()</code> is a method 97 on a <code class="classname">DB</code> handle." 98 </p> 99 <p> 100 Variable or non-literal text is presented in <span class="emphasis"><em>italics</em></span>. For example: "Go to your 101 <span class="emphasis"><em>DB_INSTALL</em></span> directory." 102 </p> 103 <p> 104 Program examples are displayed in a <code class="classname">monospaced font</code> on a shaded background. 105 For example: 106 </p> 107 <pre class="programlisting">/* File: gettingstarted_common.h */ 108typedef struct stock_dbs { 109 DB *inventory_dbp; /* Database containing inventory information */ 110 DB *vendor_dbp; /* Database containing vendor information */ 111 112 char *db_home_dir; /* Directory containing the database 113 * files */ 114 char *inventory_db_name; /* Name of the inventory database */ 115 char *vendor_db_name; /* Name of the vendor database */ 116} STOCK_DBS; </pre> 117 <p> 118 In some situations, programming examples are updated from one chapter to the next. When 119 this occurs, the new code is presented in <strong class="userinput"><code>monospaced bold</code></strong> font. For example: 120 </p> 121 <pre class="programlisting">typedef struct stock_dbs { 122 DB *inventory_dbp; /* Database containing inventory information */ 123 DB *vendor_dbp; /* Database containing vendor information */ 124 <strong class="userinput"><code>DB *itemname_sdbp; /* Index based on the item name index */</code></strong> 125 char *db_home_dir; /* Directory containing the database 126 * files */ 127 <strong class="userinput"><code>char *itemname_db_name; /* Itemname secondary database */</code></strong> 128 char *inventory_db_name; /* Name of the inventory database */ 129 char *vendor_db_name; /* Name of the vendor database */ 130} STOCK_DBS; </pre> 131 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"> 132 <h3 class="title">Note</h3> 133 <p> 134 Finally, notes of special interest are represented using a note block such 135 as this. 136 </p> 137 </div> 138 <div class="sect2" lang="en" xml:lang="en"> 139 <div class="titlepage"> 140 <div> 141 <div> 142 <h3 class="title"><a id="moreinfo"></a>For More Information</h3> 143 </div> 144 </div> 145 </div> 146 <p> 147 Beyond this manual, you may also find the following sources of information useful when building a 148 transactional DB application: 149 </p> 150 <div class="itemizedlist"> 151 <ul type="disc"> 152 <li> 153 <p> 154 <a class="ulink" href="http://www.oracle.com/technology/documentation/berkeley-db/db/gsg_txn/C/index.html" target="_top"> 155 Getting Started with Transaction Processing for C 156 </a> 157 158 159 160 161 162 163 </p> 164 </li> 165 <li> 166 <p> 167 <a class="ulink" href="http://www.oracle.com/technology/documentation/berkeley-db/db/gsg/C/index.html" target="_top"> 168 Getting Started with Berkeley DB for C 169 </a> 170 171 172 173 174 175 176 177 </p> 178 </li> 179 <li> 180 <p> 181 <a class="ulink" href="http://www.oracle.com/technology/documentation/berkeley-db/db/programmer_reference/index.html" target="_top"> 182 Berkeley DB Programmer's Reference Guide 183 </a> 184 </p> 185 </li> 186 <li> 187 <p> 188 <span> 189 <a class="ulink" href="http://www.oracle.com/technology/documentation/berkeley-db/db/api_reference/C/frame_main.html" target="_top"> 190 Berkeley DB C API 191 </a> 192 193 </span> 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 Replicated Berkeley DB Applications </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</td> 219 </tr> 220 </table> 221 </div> 222 </body> 223</html> 224