1<!--$Id: intro.so,v 1.28 2008/05/05 05:22:43 alexg Exp $--> 2<!--Copyright (c) 1997,2008 Oracle. All rights reserved.--> 3<!--See the file LICENSE for redistribution information.--> 4<html> 5<head> 6<title>Berkeley DB Reference Guide: Building for VxWorks 5.4 and 5.5</title> 7<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> 8<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> 9</head> 10<body bgcolor=white> 11<a name="2"><!--meow--></a> 12<table width="100%"><tr valign=top> 13<td><b><dl><dt>Berkeley DB Reference Guide:<dd>Building Berkeley DB for VxWorks systems</dl></b></td> 14<td align=right><a href="../build_wince/notes.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../toc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../build_vxworks/intro6x.html"><img src="../../images/next.gif" alt="Next"></a> 15</td></tr></table> 16<p align=center><b>Building for VxWorks 5.4 and 5.5</b></p> 17<p>The build_vxworks directory in the Berkeley DB distribution contains a workspace 18and project files for Tornado 2.0/VxWorks 5.4 and Tornado 2.2/VxWorks 5.5.</p> 19<table border=1 align=center> 20<tr><th>File</th><th>Description</th></tr> 21<tr> <td align=left>BerkeleyDB20.wsp</td> <td align=left>Berkeley DB Workspace file for Tornado 2.0</td> </tr> 22<tr> <td align=left>BerkeleyDB20.wpj</td> <td align=left>Berkeley DB Project file for Tornado 2.0</td> </tr> 23<tr> <td align=left>BerkeleyDB22.wsp</td> <td align=left>Berkeley DB Workspace file for Tornado 2.2</td> </tr> 24<tr> <td align=left>BerkeleyDB22.wpj</td> <td align=left>Berkeley DB Project file for Tornado 2.2</td> </tr> 25<tr> <td align=left>dbdemo/dbdemo20.wpj</td> <td align=left><a href="../../ref/build_vxworks/notes.html">Demo program</a> project file for Tornado 2.0</td> </tr> 26<tr> <td align=left>dbdemo/dbdemo22.wpj</td> <td align=left><a href="../../ref/build_vxworks/notes.html">Demo program</a> project file for Tornado 2.2</td> </tr> 27<tr> <td align=left>db_*/*20.wpj</td> <td align=left><a href="../../ref/build_vxworks/notes.html">Support utilities</a> project files for Tornado 2.0</td> </tr> 28<tr> <td align=left>db_*/*22.wpj</td> <td align=left><a href="../../ref/build_vxworks/notes.html">Support utilities</a> project files for Tornado 2.2</td> </tr> 29</table> 30<b>Building With Tornado 2.0 or Tornado 2.2</b> 31<p>Open the workspace <b>BerkeleyDB20.wsp</b> or <b>BerkeleyDB22.wsp</b>. 32The list of projects in this workspace will be shown. These projects 33were created for the x86 BSP for VxWorks.</p> 34<p>The remainder of this document assumes that you already have a VxWorks 35target and a target server, both up and running. It also assumes that 36your VxWorks image is configured properly for your needs. It also 37assumes that you have an acceptable file system already available. 38See <a href="../../ref/build_vxworks/faq.html">VxWorks FAQ</a> for more 39information about file system requirements. 40See <a href="../../ref/build_vxworks/notes.html">VxWorks Notes</a> for more 41information about building a small footprint version of Berkeley DB.</p> 42<p>First, you need to set the include directories. To do this, go to the 43<i>Builds</i> tab for the workspace. Open up <i>Berkeley DB 44Builds</i>. You will see several different builds, containing different 45configurations. All of the projects in the Berkeley DB workspace are created 46to be downloadable applications.</p> 47<table border=1 align=center> 48<tr><th>Build</th><th>Description</th></tr> 49<tr> <td align=left>PENTIUM_debug</td> <td align=left>x86 BSP with debugging</td> </tr> 50<tr> <td align=left>PENTIUM_release</td> <td align=left>x86 BSP no debugging</td> </tr> 51</table> 52<p>You have to add a new build specification if you use a 53different BSP, want to add a build for the simulator or 54want to customize further. For instance, if you have the Power PC (PPC) 55BSP, you need to add a new build for the PPC tool chain. To do so, 56select the "Builds" tab, select the Berkeley DB project name, and right-click. 57Choose the <i>New Build...</i> selection and create the new build 58target. For your new build target, you need to decide whether 59it should be built for 60debugging. See the properties of the Pentium builds for ways to 61configure for each case. After you add this build you, you still need 62to configure correctly the include directories, as described in the 63sections that follow.</p> 64<p>If you are running with a different 65BSP, you should remove the build specifications that do not apply to 66your hardware. We recommend that you do this after you configure any 67new build specifications first. The Tornado tools will get confused if 68you have a PENTIUMgnu build specification for a PPC BSP, 69for instance.</p> 70<p>Select the build you are interested in, and right-click. Choose the 71<i>Properties...</i> selection. At this point, a tabbed dialog 72should appear. In this new window, choose the <i>C/C++ compiler</i> 73tab. In the edit box, you need to modify the full pathname of the 74<i>build_vxworks</i> subdirectory of Berkeley DB, followed by the full 75pathname of Berkeley DB. Then, click OK. 76Note that some versions of Tornado (such as the version for Windows) 77do not correctly handle relative pathnames in the include paths.</p> 78<p>To build and download the Berkeley DB downloadable application for the first time 79requires several steps: </p> 80<ol> 81<p><li>Select the build you are interested in, and right-click. Choose the 82<i>Set... as Active Build</i> selection. 83<p><li>Select the build you are interested in, and right-click. Choose the 84<i>Dependencies...</i> selection. Run dependencies over all files 85in the Berkeley DB project. 86<p><li>Select the build you are interested in, and right-click. Choose the 87<i>Rebuild All (Berkeley DB.out)</i> selection. 88<p><li>Select the Berkeley DB project name, and right-click. Choose the 89<i>Download "Berkeley DB.out"</i> selection. 90</ol> 91<p>Note that the output file listed about will really be listed as 92<i>BerkeleyDB20.out</i> or <i>BerkeleyDB22.out</i> 93depending on which version of Tornado you are running. 94You need to repeat this procedure for all builds you are interested in 95building, as well as for all of the utility project builds you want to 96run.</p> 97<table width="100%"><tr><td><br></td><td align=right><a href="../build_wince/notes.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../toc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../build_vxworks/intro6x.html"><img src="../../images/next.gif" alt="Next"></a> 98</td></tr></table> 99<p><font size=1>Copyright (c) 1996,2008 Oracle. All rights reserved.</font> 100</body> 101</html> 102
