×
Namespaces

Variants
Actions

E32Image file format on pre-Symbian OS 9

From Nokia Developer Wiki
Jump to: navigation, search
Article Metadata
Compatibility
Platform(s):
Symbian
Article
Created: antonypr (27 Jun 2007)
Last edited: hamishwillee (20 Jul 2012)

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.


Contents

Introduction

The executable files in pre-Symbian OS 9, i.e. .app, .exe or .dll, 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 .app or .dll 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 f32image.h. It is part of the public Symbian SDKs located at \epoc32\include.

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;
};
  • 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 (.obj) 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 EPriorityForeground, it means priority for the foreground tasks.


Internal links


External links

This page was last modified on 20 July 2012, at 10:05.
51 page views in the last 30 days.

Was this page helpful?

Your feedback about this content is important. Let us know what you think.

 

Thank you!

We appreciate your feedback.

×