###

Berkeley DB Reference Guide:
  Building Berkeley DB for VxWorks systems

# Building for VxWorks

The build_vxworks directory in the Berkeley DB distribution contains a workspace and project files for Tornado 2.0.

File | Description
--- | ---
Berkeley DB.wsp | Berkeley DB Workspace file
Berkeley DB.wpj | Berkeley DB Project file
ex_*/*.wpj | Example programs project files

### Building With Tornado 2.0

Open the workspace Berkeley DB.wsp. The list of projects in this workspace will be shown. These projects were created for the x86 BSP for VxWorks.

The remainder of this document assumes you already have a VxWorks target and a target server, both up and running.

First, you'll need to set the include directories. To do this, go to the Builds tab for the workspace. Open up Berkeley DB Builds. You will see several different builds, containing different configurations. All of the projects in the Berkeley DB workspace are created to be downloadable applications.

Build | Description
--- | ---
PENTIUM_RPCdebug | x86 BSP with RPC and debugging
PENTIUM_RPCnodebug | x86 BSP with RPC no debugging
PENTIUM_debug | x86 BSP no RPC with debugging
PENTIUM_nodebug | x86 BSP no RPC no debugging
SIMSPARCSOLARISgnu | VxSim BSP no RPC with debugging

You will have to add a new build specification if you are using a different BSP or wish to customize further. For instance, if you have the Power PC (PPC) BSP, you will need to add a new build for the PPC tool chain. To do so, select the "Builds" tab and then select the Berkeley DB project name and right click. Choose the New Build... selection and create the new build target. For your new build target, you will need to decide if you want it configured to support RPC and whether it should be built for debugging. See the properties of the Pentium builds for how to configure for each case. After you have added this build you still need to correctly configure the include directories as described below.

Select the build you are interested in and right click. Choose the Properties... selection. At this point, a tabbed dialogue should appear. In this new window, choose the C/C++ compiler tab. In the edit box, you need to modify the full pathname of the build_vxworks subdirectory of Berkeley DB, followed by the full pathname of the include subdirectory of Berkeley DB. Then click OK.

If the architecture for this new build has the most significant byte first, you will also need to edit the db_config.h file in the build directory and define WORDS_BIGENDIAN.

To build and download the Berkeley DB downloadable application for the first time requires several steps:

1. Select the build you are interested in and right click. Choose the Set ... as Active Build selection.

2. Select the build you are interested in and right click. Choose the Dependencies ... selection. Run dependencies over all files in the Berkeley DB project.

3. Select the build you are interested in and right click. Choose the Rebuild All (Berkeley DB.out) selection.

4. Select the Berkeley DB project name and right click. Choose the Download 'Berkeley DB.out' selection.

You will need to repeat this procedure for all builds you are interested in building, as well as for all of the example project builds you wish to run.

Copyright Sleepycat Software