How to use GenerateLibDB

When analysing specific Symbian OS binaries for imported DLLs, a list of ordinal numbers per DLL that each binary links to is produced. These ordinal numbers must be mapped to their corresponding function names before any migration information may be extracted from the Migration Guide Index.

This process may take a long time and, therefore, it is advisable that you run a tool called GenerateLibDB before running MigrationCheck. GenerateLibDB produces a text file listing all the mappings of ordinal numbers and function names within a specified Symbian OS version. The tool can be run at any time, and the text file produced can be used as input to the MigrationCheck tool.

NOTE: If you do not run GenerateLibDB before starting MigrationCheck, it will be run as part of the comparison process, thus slowing down the comparison.

The command line syntax used for GenerateLibDB is shown below.

>GenerateLibDB.pl -p <platform> -r <directory> -o <filename> [-h]

You can run the tool from anywhere, as long as EPOCROOT is set to point to the correct Symbian OS version.

These are the arguments used with the GenerateLibDB tool.

The following examples show how to generate a file listing all the mappings of ordinal numbers and function names:

>GenerateLibDB.pl -p arm4 -o myLibDB.dat

or

>GenerateLibDB.pl -r m:\epoc32\release\arm4\urel

• Introduction to MigrationCheck

• How to use MigrationCheck