Installing the CDB tool in CDB CookBook

Install the CDB tool in a location that is outside the epoc32 tree as outlined in Steps to install the CDB tool. Avoid installing the CDB tool in a location within epoc32 tree for the following reasons:

it dirties your environment from CBR perspective
CDB installation will be removed when cleanenv operation is performed.

Install the CDB tool to the root of the drive containing the epoc tree. In this example, it is copied to drive J. Having installed, the root of this drive will look like this:

By default, this location is not in your PATH, therefore add '\' (or J:\) to your path, this executes the copy of CDB tool depending on the drive in which you are.

Set the following properties in the properties file:

Property	Change to	Reason
`cdb.env.cppfilt.eabi = ${cdb.env.epoc32tree}tools\\cdb\\c++filt.exe`	`\cdb\c++filt.exe`	CDB location has changed
`cdb.db.script = ${cdb.env.epoc32tree}tools\\cdb\\cdb.sql`	`\cdb\cdb.sql`	CDB location has changed
`cdb.db.path = ${cdb.env.epoc32tree}data\\cdb.db`	`\databases\cdb.db`	To stop getting deleted when cleanenv is called.
`cdb.report.stylesheet = ${cdb.env.epoc32tree}tools\\cdb\\bcstyle.xsl`	`\cdb\bcstyle.xsl`	CDB location has changed

The location of the properties file is changed, communicated this change to CDB through command line. To install the CDB permanently, modify the cdb.pl file as follows:

<< system "$toolsdir\\cdb\\cdb.exe -e $epocroot @ARGV\n";

>> system "$toolsdir\\cdb\\cdb.exe -e $epocroot -p \\cdb\\cdb.properties @ARGV\n";

Now you can call CDB like this:

cdb <command>

You can also call CDB like this:

cdb –p cdb\cdb.properties <command>

CDB can be installed once in a drive and used from other drives. This is done by maintaining a separate cdb.properties file for each epoc tree. Change these properties in each of the file:

Property	Change to	Reason
`cdb.db.path = ${cdb.env.epoc32tree}data\\cdb.db`	The absolute location of the database	When you run the CDB from a drive, it uses the appropriate database for that drive.
`cdb.extract.gxp.path = ${cdb.env.epoc32tree}release\\gccxml\\urel\\`	The absolute location of the `gccxml\urel` directory	When you run CDB from a given drive, it uses GXPs built from the EPOC tree in that drive.

For example, if you wish to use the CDB in M drive (remember that it is configured for J drive), you would create a copy of the cdb.properties file in some location, set its values to suit the J drive, and save it. This can be saved as j.properties. Then, when running the CDB, use the –p flag to set the relevant properties in a properties file.

Installing the CDB tool

Using single installation