Symbian
Symbian OS Library

SYMBIAN OS V9.3

[Index] [Spacer] [Previous] [Next]



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.


GenerateLibDB command line syntax

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.


Arguments

These are the arguments used with the GenerateLibDB tool.

-p <platform>

Specifies the Symbian OS platform to be used, for example ARM4, ARMv5, ARMi, Thumb etc.. The default is ARM4.

-r <directory>

Specifies the full path of the release directory, where the libraries are to be found, for example epoc32/release/arm4/urel.

-o <filename>

Specifies the name and path of the output data file, for example cwd/SymLibDB.dat.

-h

Displays help information (optional).


Examples

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

[Top]


See also