From Forum Nokia Wiki

You do not have permission to edit this page, for the following reason:

You can view and copy the source of this page:

This article explains briefly about [[E32Image]] file format on pre-Symbian OS 9. Please check some links at the end of this article for more detail information. == Introduction == The executable files in pre-Symbian OS 9, i.e. <tt>.app</tt>, <tt>.exe</tt> or <tt>.dll</tt>, use a special format, called E32Image. It is based on PE file format. E32Image added some Symbian-specific information to the header. It replaces function names with ordinal numbers. The tool used to translate PE into E32Image is called [[petran]]. Like PE executable file, E32Image contains of several sections, i.e.: * '''Code section'''. It contains three parts, text section, export address table and import address table. * '''BSS section'''. It contains un-initialized data. This section is usually not available. * '''Data section'''. It contains initialized data. Since most pre Symbian OS 9 applications are <tt>.app</tt> or <tt>.dll</tt> format, this section usually does not exist either. * '''Import section'''. It contains the information about all imported functions used by the code. * '''Relocation section'''. It contains relocation table needed by Symbian OS loader to load the code. == Header information == The header information of E32Image is defined in a header file called <tt>f32image.h</tt>. It is part of the public Symbian SDKs located at <tt>\epoc32\include</tt>. <code cpp> class E32ImageHeader { public: TUint32 iUid1; TUint32 iUid2; TUint32 iUid3; TUint32 iCheck; TUint iSignature; TCpu iCpu; TUint iCheckSumCode; TUint32 iFormat; TVersion iVersion; TInt64 iTime; TUint iFlags; TInt iCodeSize; TInt iDataSize; TInt iHeapSizeMin; TInt iHeapSizeMax; TInt iStackSize; TInt iBssSize; TUint iEntryPoint; TUint iCodeBase; TUint iDataBase; TInt iDllRefTableCount; TUint iExportDirOffset; TInt iExportDirCount; TInt iTextSize; TUint iCodeOffset; TUint iDataOffset; TUint iImportOffset; TUint iCodeRelocOffset; TUint iDataRelocOffset; TProcessPriority iPriority; }; </code> * '''TUint32 iUid1''', '''TUint32 iUid2''', '''TUint32 iUid3''', represent the identifiers that uniquely identify the application. * '''TUint32 iCheck''', is the checksum of the first three UIDs. * '''TUint iSignature''', is a unique signature of E32 file, always has a value 'EPOC'. * '''TCpu iCpu''', the platform of the programs, usually has a value ECpuX86 = 0x1000 for the Intel processor and ECpuArm = 0x2000 for the ARM processor. * '''TUint iCheckSumCode''', is checksum of the code section. It is the sum of all 32 bits words in the code section. * '''TUint iCheckSumData''', is checksum of all 32 bit words in the data section. This field is normally 0. * '''TVersion iVersion''', the version of PETRAN used to generate this E32 file. * '''TInt64 iTime''', is the timestamp when the application was built. * '''TUint iFlags''', is a flag with the value 0 for .exe, 1 for .dll and +2 for no call of entry points. * '''TInt iCodeSize''', the size of the code section. * '''TInt iDataSize''', the size of the initialized data section. This field is normally 0. * '''TInt iHeapSizeMin''', the minimum size of the heap. * '''TInt iHeapSizeMax''', the maximum size of the heap. * '''TInt iStackSize''', the size of the stack. * '''TInt iBssSize''', the size of the un-initialized data section. * '''TUint iEntryPoint''', the offset into code of entry point. * '''TUint iCodeBase''', where the code is linked for. * '''TUint iDataBase''', where the data is linked for. * '''TInt iDllRefTableCount''', the number of DLLs imported by this program. * '''TUint iExportDirOffset''', the offset of the export address table. * '''TInt iExportDirCount''', the number of functions exported by this program. * '''TInt iTextSize''', the size of the text section, i.e. the size of all the object files (<tt>.obj</tt>) compiled from the source code. * '''TUint iCodeOffset''', the file offset to the code section. * '''TUint iDataOffset''', the file offset to the data section. This field is normally 0. * '''TUint iImportOffset''', the file offset to the import section. * '''TUint iCodeRelocOffset''', relocation offset for code and constant. * '''TUint iDataRelocOffset''', relocation offset for data. * '''TProcessPriority iPriority''', the priority of this process, for normal applications the value is <tt>EPriorityForeground</tt>, it means priority for the foreground tasks. == Internal links == * [[ABI|Application Binary Interface]] * [[E32Image|Introduction to E32Image]] * [[E32Image file format on Symbian OS 9]] == External links == * [http://www.antonypranata.com/articles/symbian-os-executable-file-format-e32image Symbian OS Executable File Format (E32Image)] * [http://www.antonypranata.com/articles/new-symbian-os-9-executable-file-format-e32image New Symbian OS 9 Executable File Format (E32Image)] * [http://en.wikipedia.org/wiki/Portable_Executable Portable Executable on Wikipedia] * [http://en.wikipedia.org/wiki/Executable_and_Linkable_Format Executable and Linkable Format Executable on Wikipedia] [[Category:Hardware]][[Category:Symbian OS]]

Return to E32Image file format on pre-Symbian OS 9.