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>Chapter 30. Building Berkeley DB for VxWorks</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="Berkeley DB Programmer's Reference Guide" /> 10 <link rel="up" href="index.html" title="Berkeley DB Programmer's Reference Guide" /> 11 <link rel="prev" href="build_wince_faq.html" title="Windows CE/Mobile FAQ" /> 12 <link rel="next" href="build_vxworks_intro6x.html" title="Building for VxWorks 6.x" /> 13 </head> 14 <body> 15 <div class="navheader"> 16 <table width="100%" summary="Navigation header"> 17 <tr> 18 <th colspan="3" align="center">Chapter 30. 19 Building Berkeley DB for VxWorks 20 </th> 21 </tr> 22 <tr> 23 <td width="20%" align="left"><a accesskey="p" href="build_wince_faq.html">Prev</a> </td> 24 <th width="60%" align="center"> </th> 25 <td width="20%" align="right"> <a accesskey="n" href="build_vxworks_intro6x.html">Next</a></td> 26 </tr> 27 </table> 28 <hr /> 29 </div> 30 <div class="chapter" lang="en" xml:lang="en"> 31 <div class="titlepage"> 32 <div> 33 <div> 34 <h2 class="title"><a id="build_vxworks"></a>Chapter 30. 35 Building Berkeley DB for VxWorks 36 </h2> 37 </div> 38 </div> 39 </div> 40 <div class="toc"> 41 <p> 42 <b>Table of Contents</b> 43 </p> 44 <dl> 45 <dt> 46 <span class="sect1"> 47 <a href="build_vxworks.html#build_vxworks_intro">Building for VxWorks 5.4 and 5.5</a> 48 </span> 49 </dt> 50 <dd> 51 <dl> 52 <dt> 53 <span class="sect2"> 54 <a href="build_vxworks.html#id1634577">Building With Tornado 2.0 or Tornado 2.2</a> 55 </span> 56 </dt> 57 </dl> 58 </dd> 59 <dt> 60 <span class="sect1"> 61 <a href="build_vxworks_intro6x.html">Building for VxWorks 6.x</a> 62 </span> 63 </dt> 64 <dd> 65 <dl> 66 <dt> 67 <span class="sect2"> 68 <a href="build_vxworks_intro6x.html#id1634680">Building With Wind River Workbench using the Makefile</a> 69 </span> 70 </dt> 71 </dl> 72 </dd> 73 <dt> 74 <span class="sect1"> 75 <a href="build_vxworks_notes.html">VxWorks notes</a> 76 </span> 77 </dt> 78 <dd> 79 <dl> 80 <dt> 81 <span class="sect2"> 82 <a href="build_vxworks_notes.html#id1634647">Building and Running the Demo Program</a> 83 </span> 84 </dt> 85 <dt> 86 <span class="sect2"> 87 <a href="build_vxworks_notes.html#id1634846">Building and Running the Utility Programs</a> 88 </span> 89 </dt> 90 <dt> 91 <span class="sect2"> 92 <a href="build_vxworks_notes.html#id1634749">VxWorks 5.4/5.5: shared memory</a> 93 </span> 94 </dt> 95 <dt> 96 <span class="sect2"> 97 <a href="build_vxworks_notes.html#id1634867">VxWorks 5.4/5.5: building a small memory footprint library</a> 98 </span> 99 </dt> 100 </dl> 101 </dd> 102 <dt> 103 <span class="sect1"> 104 <a href="build_vxworks_faq.html">VxWorks FAQ</a> 105 </span> 106 </dt> 107 </dl> 108 </div> 109 <div class="sect1" lang="en" xml:lang="en"> 110 <div class="titlepage"> 111 <div> 112 <div> 113 <h2 class="title" style="clear: both"><a id="build_vxworks_intro"></a>Building for VxWorks 5.4 and 5.5</h2> 114 </div> 115 </div> 116 </div> 117 <div class="toc"> 118 <dl> 119 <dt> 120 <span class="sect2"> 121 <a href="build_vxworks.html#id1634577">Building With Tornado 2.0 or Tornado 2.2</a> 122 </span> 123 </dt> 124 </dl> 125 </div> 126 <p>The build_vxworks directory in the Berkeley DB distribution contains a workspace 127and project files for Tornado 2.0/VxWorks 5.4 and Tornado 2.2/VxWorks 5.5.</p> 128 <div class="informaltable"> 129 <table border="1" width="80%"> 130 <colgroup> 131 <col /> 132 <col /> 133 </colgroup> 134 <thead> 135 <tr> 136 <th>File</th> 137 <th>Description</th> 138 </tr> 139 </thead> 140 <tbody> 141 <tr> 142 <td align="left">BerkeleyDB20.wsp</td> 143 <td align="left">Berkeley DB Workspace file for Tornado 2.0</td> 144 </tr> 145 <tr> 146 <td align="left">BerkeleyDB20.wpj</td> 147 <td align="left">Berkeley DB Project file for Tornado 2.0</td> 148 </tr> 149 <tr> 150 <td align="left">BerkeleyDB22.wsp</td> 151 <td align="left">Berkeley DB Workspace file for Tornado 2.2</td> 152 </tr> 153 <tr> 154 <td align="left">BerkeleyDB22.wpj</td> 155 <td align="left">Berkeley DB Project file for Tornado 2.2</td> 156 </tr> 157 <tr> 158 <td align="left">dbdemo/dbdemo20.wpj</td> 159 <td align="left"><a class="xref" href="build_vxworks_notes.html" title="VxWorks notes">VxWorks notes</a> project file for Tornado 2.0</td> 160 </tr> 161 <tr> 162 <td align="left">dbdemo/dbdemo22.wpj</td> 163 <td align="left"><a class="xref" href="build_vxworks_notes.html" title="VxWorks notes">VxWorks notes</a> project file for Tornado 2.2</td> 164 </tr> 165 <tr> 166 <td align="left">db_*/*20.wpj</td> 167 <td align="left"><a class="xref" href="build_vxworks_notes.html" title="VxWorks notes">VxWorks notes</a> project files for Tornado 2.0</td> 168 </tr> 169 <tr> 170 <td align="left">db_*/*22.wpj</td> 171 <td align="left"><a class="xref" href="build_vxworks_notes.html" title="VxWorks notes">VxWorks notes</a> project files for Tornado 2.2</td> 172 </tr> 173 </tbody> 174 </table> 175 </div> 176 <div class="sect2" lang="en" xml:lang="en"> 177 <div class="titlepage"> 178 <div> 179 <div> 180 <h3 class="title"><a id="id1634577"></a>Building With Tornado 2.0 or Tornado 2.2</h3> 181 </div> 182 </div> 183 </div> 184 <p>Open the workspace <span class="bold"><strong>BerkeleyDB20.wsp</strong></span> or <span class="bold"><strong>BerkeleyDB22.wsp</strong></span>. 185The list of projects in this workspace will be shown. These projects 186were created for the x86 BSP for VxWorks.</p> 187 <p>The remainder of this document assumes that you already have a VxWorks 188target and a target server, both up and running. It also assumes that 189your VxWorks image is configured properly for your needs. It also 190assumes that you have an acceptable file system already available. 191See <a class="xref" href="build_vxworks_faq.html" title="VxWorks FAQ">VxWorks FAQ</a> for more 192information about file system requirements. 193See <a class="xref" href="build_vxworks_notes.html" title="VxWorks notes">VxWorks notes</a> for more 194information about building a small footprint version of Berkeley DB.</p> 195 <p>First, you need to set the include directories. To do this, go to the 196<span class="emphasis"><em>Builds</em></span> tab for the workspace. Open up <span class="emphasis"><em>Berkeley DB 197Builds</em></span>. You will see several different builds, containing different 198configurations. All of the projects in the Berkeley DB workspace are created 199to be downloadable applications.</p> 200 <div class="informaltable"> 201 <table border="1" width="80%"> 202 <colgroup> 203 <col /> 204 <col /> 205 </colgroup> 206 <thead> 207 <tr> 208 <th>Build</th> 209 <th>Description</th> 210 </tr> 211 </thead> 212 <tbody> 213 <tr> 214 <td align="left">PENTIUM_debug</td> 215 <td align="left">x86 BSP with debugging</td> 216 </tr> 217 <tr> 218 <td align="left">PENTIUM_release</td> 219 <td align="left">x86 BSP no debugging</td> 220 </tr> 221 </tbody> 222 </table> 223 </div> 224 <p>You have to add a new build specification if you use a 225different BSP, want to add a build for the simulator or 226want to customize further. For instance, if you have the Power PC (PPC) 227BSP, you need to add a new build for the PPC tool chain. To do so, 228select the "Builds" tab, select the Berkeley DB project name, and right-click. 229Choose the <span class="emphasis"><em>New Build...</em></span> selection and create the new build 230target. For your new build target, you need to decide whether 231it should be built for 232debugging. See the properties of the Pentium builds for ways to 233configure for each case. After you add this build you, you still need 234to configure correctly the include directories, as described in the 235sections that follow.</p> 236 <p>If you are running with a different 237BSP, you should remove the build specifications that do not apply to 238your hardware. We recommend that you do this after you configure any 239new build specifications first. The Tornado tools will get confused if 240you have a PENTIUMgnu build specification for a PPC BSP, 241for instance.</p> 242 <p>Select the build you are interested in, and right-click. Choose the 243<span class="emphasis"><em>Properties...</em></span> selection. At this point, a tabbed dialog 244should appear. In this new window, choose the <span class="emphasis"><em>C/C++ compiler</em></span> 245tab. In the edit box, you need to modify the full pathname of the 246<span class="emphasis"><em>build_vxworks</em></span> subdirectory of Berkeley DB, followed by the full 247pathname of Berkeley DB. Then, click OK. 248Note that some versions of Tornado (such as the version for Windows) 249do not correctly handle relative pathnames in the include paths.</p> 250 <p>To build and download the Berkeley DB downloadable application for the first time 251requires several steps: </p> 252 <div class="orderedlist"> 253 <ol type="1"> 254 <li>Select the build you are interested in, and right-click. Choose the 255<span class="emphasis"><em>Set... as Active Build</em></span> selection.</li> 256 <li>Select the build you are interested in, and right-click. Choose the 257<span class="emphasis"><em>Dependencies...</em></span> selection. Run dependencies over all files 258in the Berkeley DB project.</li> 259 <li>Select the build you are interested in, and right-click. Choose the 260<span class="emphasis"><em>Rebuild All (Berkeley DB.out)</em></span> selection.</li> 261 <li>Select the Berkeley DB project name, and right-click. Choose the 262<span class="emphasis"><em>Download "Berkeley DB.out"</em></span> selection.</li> 263 </ol> 264 </div> 265 <p>Note that the output file listed about will really be listed as 266<span class="emphasis"><em>BerkeleyDB20.out</em></span> or <span class="emphasis"><em>BerkeleyDB22.out</em></span> 267depending on which version of Tornado you are running. 268You need to repeat this procedure for all builds you are interested in 269building, as well as for all of the utility project builds you want to 270run.</p> 271 </div> 272 </div> 273 </div> 274 <div class="navfooter"> 275 <hr /> 276 <table width="100%" summary="Navigation footer"> 277 <tr> 278 <td width="40%" align="left"><a accesskey="p" href="build_wince_faq.html">Prev</a> </td> 279 <td width="20%" align="center"> </td> 280 <td width="40%" align="right"> <a accesskey="n" href="build_vxworks_intro6x.html">Next</a></td> 281 </tr> 282 <tr> 283 <td width="40%" align="left" valign="top">Windows CE/Mobile FAQ </td> 284 <td width="20%" align="center"> 285 <a accesskey="h" href="index.html">Home</a> 286 </td> 287 <td width="40%" align="right" valign="top"> Building for VxWorks 6.x</td> 288 </tr> 289 </table> 290 </div> 291 </body> 292</html> 293