e32tools/elf2e32/source/imgdump.cpp
author timothy.murphy@nokia.com
Tue, 13 Apr 2010 17:35:43 +0100
branchfix
changeset 483 941b2742ee49
parent 0 044383f39525
child 590 360bd6b35136
permissions -rw-r--r--
Fix a copyright date. Make sure all FLMBDEBUG usage is wrapped in <debug> tags.

// Copyright (c) 2005-2009 Nokia Corporation and/or its subsidiary(-ies).
// All rights reserved.
// This component and the accompanying materials are made available
// under the terms of "Eclipse Public License v1.0"
// which accompanies this distribution, and is available
// at the URL "http://www.eclipse.org/legal/epl-v10.html".
//
// Initial Contributors:
// Nokia Corporation - initial contribution.
//
// Contributors:
//
// Description:
// Implementation of the e32 image dump for the elf2e32 tool
// @internalComponent
// @released
// 
//

#define __REFERENCE_CAPABILITY_NAMES__

#include "e32imagefile.h"
#include "pl_common.h"
#include <string.h>
#include <stdarg.h>
#include <stdio.h>

#ifdef __LINUX__ 
    #define VSNPRINTF vsnprintf
#else 
    #define VSNPRINTF _vsnprintf
#endif 

using std::cout;

const TInt KMaxStringLength=0x400;

/**
Variadic Function to print string.

@internalComponent
@released

@param aFmt
Formatted string.
*/
void PrintString(const char *aFmt,...)
{
	TText imageText[KMaxStringLength];
	va_list list;
	va_start(list,aFmt);
	VSNPRINTF((char *)imageText,KMaxStringLength,aFmt,list);
	va_end(list);
	cout << imageText;

	cout.flush();
}

/**
Function to set priority.

@internalComponent
@released

@param aPri
Priority Type passed in
@param aStr
The priority value corresponding to the appropriate priority type
*/
void PriorityToStr(TProcessPriority aPri, char *aStr)
{
	if (aPri==EPrioritySupervisor)
		strcpy(aStr,"Supervisor");

	else if (aPri>EPriorityRealTimeServer)
		sprintf(aStr, "RealTime+%d", aPri-EPriorityRealTimeServer);
	else if (aPri==EPriorityRealTimeServer)
		strcpy(aStr,"RealTime");

	else if (aPri>EPriorityFileServer)
		sprintf(aStr, "FileServer+%d", aPri-EPriorityFileServer);
	else if (aPri==EPriorityFileServer)
		strcpy(aStr,"FileServer");

	else if (aPri>EPriorityWindowServer)
		sprintf(aStr, "WindowServer+%d", aPri-EPriorityWindowServer);
	else if (aPri==EPriorityWindowServer)
		strcpy(aStr,"WindowServer");

	else if (aPri>EPriorityHigh)
		sprintf(aStr, "High+%d", aPri-EPriorityHigh);
	else if (aPri==EPriorityHigh)
		strcpy(aStr,"High");

	else if (aPri>EPriorityForeground)
		sprintf(aStr, "Foreground+%d", aPri-EPriorityForeground);
	else if (aPri==EPriorityForeground)
		strcpy(aStr,"Foreground");

	else if (aPri>EPriorityBackground)
		sprintf(aStr, "Background+%d", aPri-EPriorityBackground);
	else if (aPri==EPriorityBackground)
		strcpy(aStr,"Background");

	else if (aPri>EPriorityLow)
		sprintf(aStr, "Low+%d", aPri-EPriorityLow);
	else if (aPri==EPriorityLow)
		strcpy(aStr,"Low");

	else
		sprintf(aStr, "Illegal (%d)", aPri);
}

/**
Function to dump e32 image.

@internalComponent
@released

@param aFileName
Name of the E32image to be dumped.
@param aDumpFlags
sub options passed to the 'dump' option
*/
void E32ImageFile::Dump(TText *aFileName,TInt aDumpFlags)
{
	PrintString("E32ImageFile '%s'\n", aFileName);
	DumpHeader(aDumpFlags);
	DumpData(aDumpFlags);
}

/**
Function to dump e32 image header.

@internalComponent
@released

@param aDumpFlags
The flags set based on the sub options provided to the program.
*/
void E32ImageFile::DumpHeader(TInt aDumpFlags)
{
	TUint flags = iOrigHdr->iFlags;
	TUint abi = E32ImageHeader::ABIFromFlags(flags);
	TUint hdrfmt = E32ImageHeader::HdrFmtFromFlags(flags);
	TUint impfmt = E32ImageHeader::ImpFmtFromFlags(flags);
	TUint ept = E32ImageHeader::EptFromFlags(flags);
	TBool isARM = EFalse;

	if(aDumpFlags&EDumpHeader)
	{
		PrintString("V%d.%02d(%03d)", iOrigHdr->iToolsVersion.iMajor,iOrigHdr->iToolsVersion.iMinor,iOrigHdr->iToolsVersion.iBuild);
		PrintString("\tTime Stamp: %08x,%08x\n", iOrigHdr->iTimeHi, iOrigHdr->iTimeLo);
		char sig[5];
		memcpy(sig, (const char*)&iOrigHdr->iSignature, 4);
		sig[4]=0;
		PrintString(sig);
		if (iOrigHdr->iFlags&KImageDll)
			PrintString(" Dll for ");
		else
			PrintString(" Exe for ");
		switch (iOrigHdr->CpuIdentifier())
		{
		case ECpuX86:
			PrintString("X86 CPU\n");
			break;
		case ECpuArmV4:
			isARM = ETrue;
			PrintString("ARMV4 CPU\n");
			break;
		case ECpuArmV5:
			isARM = ETrue;
			PrintString("ARMV5 CPU\n");
			break;
		case ECpuMCore:
			PrintString("M*Core CPU\n");
			break;
		case ECpuUnknown:
			PrintString("Unknown CPU\n");
			break;
		default:
			PrintString("something or other\n");
			break;
		}
		
		PrintString("Flags:\t%08x\n", flags);

		if (!(flags & KImageDll))
		{
			char str[80];
			PriorityToStr(iOrigHdr->ProcessPriority(), str);
			PrintString("Priority %s\n", str);
			if (flags & KImageFixedAddressExe)
				PrintString("Fixed process\n");
		}
		
		if (flags & KImageNoCallEntryPoint)
			PrintString("Entry points are not called\n");
		
		PrintString("Image header is format %d\n", hdrfmt>>24);
		TUint compression = iOrigHdr->CompressionType();
		
		switch (compression)
		{
		case KFormatNotCompressed:
			PrintString("Image is not compressed\n");
			break;
		case KUidCompressionDeflate:
			PrintString("Image is compressed using the DEFLATE algorithm\n");
			break;
		case KUidCompressionBytePair:
			PrintString("Image is compressed using the BYTEPAIR algorithm\n");
			break;
		default:
			PrintString("Image compression type UNKNOWN (%08x)\n", compression);
		}
		
		if (compression)
		{
			PrintString("Uncompressed size %08x\n", iOrigHdr->UncompressedFileSize());
		}

		TUint FPU = flags & KImageHWFloatMask;

		if (FPU == KImageHWFloat_None)
			PrintString("Image FPU support : Soft VFP\n");
		else if (FPU == KImageHWFloat_VFPv2) 
			PrintString("Image FPU support : VFPv2\n");
		else
			PrintString("Image FPU support : Unknown\n");

		// Code paging.

		if (flags & KImageCodeUnpaged)
		{
			PrintString("Code Paging : Unpaged\n");
		}
		else if (flags & KImageCodePaged)
		{
			PrintString("Code Paging : Paged\n");
		}
		else
		{
			PrintString("Code Paging : Default\n");
		}

		// Data paging.

		if (flags & KImageDataUnpaged)
		{
			PrintString("Data Paging : Unpaged\n");
		}
		else if (flags & KImageDataPaged)
		{
			PrintString("Data Paging : Paged\n");
		}
		else
		{
			PrintString("Data Paging : Default\n");
		}

		if (iOrigHdr->iFlags & KImageDebuggable)
		{
			PrintString("Debuggable : True\n");
		}
		else
		{
			PrintString("Debuggable : False\n");
		}
		if (iOrigHdr->iFlags & KImageSMPSafe)
		{
			PrintString("SMP Safe : True\n");
		}
		else
		{
			PrintString("SMP Safe : False\n");
		}
	}

	if (hdrfmt >= KImageHdrFmt_V && (aDumpFlags&(EDumpHeader|EDumpSecurityInfo)))
	{
		//
		// Important. Don't change output format of following security info
		// because this is relied on by used by "Symbian Signed".
		//
		E32ImageHeaderV* v = iHdr;
		PrintString("Secure ID: %08x\n", v->iS.iSecureId);
		PrintString("Vendor ID: %08x\n", v->iS.iVendorId);
		PrintString("Capabilities: %08x %08x\n", v->iS.iCaps[1], v->iS.iCaps[0]);
		if(aDumpFlags&EDumpSecurityInfo)
		{
			TInt i;
			for(i=0; i<ECapability_Limit; i++)
				if(v->iS.iCaps[i>>5]&(1<<(i&31)))
					PrintString("              %s\n", CapabilityNames[i]);
			PrintString("\n");
		}
	}

	if(aDumpFlags&EDumpHeader)
	{
		if (hdrfmt >= KImageHdrFmt_V)
		{
			E32ImageHeaderV* v = iHdr;
			TUint32 xd = v->iExceptionDescriptor;
			if ((xd & 1) && (xd != 0xffffffffu))
			{
				xd &= ~1;
				PrintString("Exception Descriptor Offset:  %08x\n", v->iExceptionDescriptor);
				TExceptionDescriptor * aED = (TExceptionDescriptor * )(iData + v->iCodeOffset + xd);
				PrintString("Exception Index Table Base: %08x\n", aED->iExIdxBase);
				PrintString("Exception Index Table Limit: %08x\n", aED->iExIdxLimit);
				PrintString("RO Segment Base: %08x\n", aED->iROSegmentBase);
				PrintString("RO Segment Limit: %08x\n", aED->iROSegmentLimit);
			}
			else
				PrintString("No Exception Descriptor\n");

			PrintString("Export Description: Size=%03x, Type=%02x\n", v->iExportDescSize, v->iExportDescType);
			
			if (v->iExportDescType != KImageHdr_ExpD_NoHoles)
			{
				TInt nb = v->iExportDescSize;
				TInt i;
				TInt j = 0;
				for (i=0; i<nb; ++i)
				{
					if (++j == 8)
					{
						j = 0;
						PrintString("\n");
					}
					PrintString(" %02x", v->iExportDesc[i]);
				}
				PrintString("\n");
			}
			
			TInt r = CheckExportDescription();
			
			if (r == KErrNone)
				PrintString("Export description consistent\n");
			else if (r == KErrNotSupported)
				PrintString("Export description type not recognised\n");
			else
				PrintString("!! Export description inconsistent !!\n");
		}

		TUint32 mv = iOrigHdr->ModuleVersion();
		PrintString("Module Version: %d.%d\n", mv>>16, mv&0xffff);
		
		if (impfmt == KImageImpFmt_PE)
		{
			PrintString("Imports are PE-style\n");
		}
		else if (impfmt == KImageImpFmt_ELF)
		{
			PrintString("Imports are ELF-style\n");
		}
		else if (impfmt == KImageImpFmt_PE2)
		{
			PrintString("Imports are PE-style without redundant ordinal lists\n");
		}
		
		if (isARM)
		{
			if (abi == KImageABI_GCC98r2)
			{
				PrintString("GCC98r2 ABI\n");
			}
			else if (abi == KImageABI_EABI)
			{
				PrintString("ARM EABI\n");
			}
			if (ept == KImageEpt_Eka1)
			{
				PrintString("Built against EKA1\n");
			}
			else if (ept == KImageEpt_Eka2)
			{
				PrintString("Built against EKA2\n");
			}
		}

		PrintString("Uids:\t\t%08x %08x %08x (%08x)\n", iOrigHdr->iUid1, iOrigHdr->iUid2, iOrigHdr->iUid3, iOrigHdr->iUidChecksum);
		
		if (hdrfmt >= KImageHdrFmt_V)
			PrintString("Header CRC:\t%08x\n", iHdr->iHeaderCrc);
		
		PrintString("File Size:\t%08x\n", iSize);
		PrintString("Code Size:\t%08x\n", iOrigHdr->iCodeSize);
		PrintString("Data Size:\t%08x\n", iOrigHdr->iDataSize);
		PrintString("Compression:\t%08x\n", iOrigHdr->iCompressionType);
		PrintString("Min Heap Size:\t%08x\n", iOrigHdr->iHeapSizeMin);
		PrintString("Max Heap Size:\t%08x\n", iOrigHdr->iHeapSizeMax);
		PrintString("Stack Size:\t%08x\n", iOrigHdr->iStackSize);
		PrintString("Code link addr:\t%08x\n", iOrigHdr->iCodeBase);
		PrintString("Data link addr:\t%08x\n", iOrigHdr->iDataBase);
		PrintString("Code reloc offset:\t%08x\n", OrigCodeRelocOffset());
		PrintString("Data reloc offset:\t%08x\n", OrigDataRelocOffset());
		PrintString("Dll ref table count: %d\n", iOrigHdr->iDllRefTableCount);

		if (iOrigHdr->iCodeSize || iOrigHdr->iDataSize || iOrigHdr->iBssSize || iOrigHdr->iImportOffset)
			PrintString("        Offset  Size  Relocs #Relocs\n");

		PrintString("Code    %06x %06x", OrigCodeOffset(), iOrigHdr->iCodeSize);
		
		if (iOrigHdr->iCodeRelocOffset)
		{
			E32RelocSection *r=(E32RelocSection *)(iData + iOrigHdr->iCodeRelocOffset);
			PrintString(" %06x %06x", OrigCodeRelocOffset(), r->iNumberOfRelocs);
		}
		else
			PrintString("              ");
		
		PrintString("        +%06x (entry pnt)", iOrigHdr->iEntryPoint);
		PrintString("\n");

		PrintString("Data    %06x %06x", OrigDataOffset(), iOrigHdr->iDataSize);
		
		if (iOrigHdr->iDataRelocOffset)
		{
			E32RelocSection *r=(E32RelocSection *)(iData + iOrigHdr->iDataRelocOffset);
			PrintString(" %06x %06x", OrigDataRelocOffset(), r->iNumberOfRelocs);
		}
		PrintString("\n");

		PrintString("Bss            %06x\n", iOrigHdr->iBssSize);

		if (iOrigHdr->iExportDirOffset)
			PrintString("Export  %06x %06x                      (%d entries)\n", OrigExportDirOffset(), iOrigHdr->iExportDirCount*4, iOrigHdr->iExportDirCount);
		
		if (iOrigHdr->iImportOffset)
			PrintString("Import  %06x\n", OrigImportOffset());
	}
}

/**
Function to dump e32 image.

@internalComponent
@released

@param aData
Data to be dumped
@param aLength
Length of the file
*/
void dump(TUint *aData, TInt aLength)
{
	TUint *p=aData;
	TInt i=0;
	char line[256];
	char *cp=(char*)aData;
	TInt j=0;
	memset(line,' ',sizeof(line));
	while (i<aLength)
	{
		TInt ccount=0;
		char* linep=&line[8*9+2];
		PrintString("%06x:", i);
		while (i<aLength && ccount<8)
		{
			PrintString(" %08x", *p++);
			i+=4;
			ccount++;
			for (j=0; j<4; j++)
			{
				char c=*cp++;
				if (c<32 || c>127)
				{
					c = '.';
				}
				*linep++ = c;
			}
		}
		*linep='\0';
		PrintString("%s", line+(ccount*9));
		PrintString("\n");
	}
}

/**
Function to dump relocations.

@internalComponent
@released

@param aRelocs
Character pointer to relocations.
*/
void dumprelocs(char *aRelocs)
{

	TInt num=((E32RelocSection *)aRelocs)->iNumberOfRelocs;
	PrintString("%d relocs\n", num);
	aRelocs+=sizeof(E32RelocSection);
	TInt printed=0;
	while (num>0)
	{
		TInt page=*(TUint *)aRelocs;
		TInt size=*(TUint *)(aRelocs+4);
		TInt pagesize=size;
		size-=8;
		TUint16 *p=(TUint16 *)(aRelocs+8);
		while (size>0)
		{
			TUint a=*p++;
			TUint relocType = (a & 0x3000) >> 12;
			if ((relocType == 1) || (relocType == 3)) //only relocation type1 and type3
			{
				PrintString("%08x(%d) ", page + (a&0x0fff), relocType);
				printed++;
				if (printed>3)
				{
					PrintString("\n");
					printed=0;
				}
			}
			size-=2;
			num--;
		}
		aRelocs+=pagesize;
	}
	PrintString("\n");
}

/**
Function to dump e32 image data.

@internalComponent
@released

@param aDumpFlags
The flags set based on the sub options provided to the program.
*/
void E32ImageFile::DumpData(TInt aDumpFlags)
{
	if(aDumpFlags&EDumpCode)
	{
		PrintString("\nCode (text size=%08x)\n", iOrigHdr->iTextSize);
		dump((TUint *)(iData + iOrigHdr->iCodeOffset), iOrigHdr->iCodeSize);
	
		if (iOrigHdr->iCodeRelocOffset)
			dumprelocs(iData + iOrigHdr->iCodeRelocOffset);
	}

	if((aDumpFlags&EDumpData) && iOrigHdr->iDataOffset)
	{
		PrintString("\nData\n");
		dump((TUint *)(iData + iOrigHdr->iDataOffset), iOrigHdr->iDataSize);
	
		if (iOrigHdr->iDataRelocOffset)
			dumprelocs(iData + iOrigHdr->iDataRelocOffset);
	}

	if(aDumpFlags&EDumpExports)
	{
		PrintString("\nNumber of exports = %d\n", iOrigHdr->iExportDirCount);
		TInt i;
		TUint* exports = (TUint*)(iData + iOrigHdr->iExportDirOffset);
		TUint absoluteEntryPoint = iOrigHdr->iEntryPoint + iOrigHdr->iCodeBase;
		TUint impfmt = iOrigHdr->ImportFormat();
		TUint absentVal = (impfmt == KImageImpFmt_ELF) ? absoluteEntryPoint : iOrigHdr->iEntryPoint;
		for (i=0; i<iOrigHdr->iExportDirCount; ++i)
		{
			TUint exp = exports[i];
			if (exp == absentVal)
				PrintString("\tOrdinal %5d:\tABSENT\n", i+1);
			else
				PrintString("\tOrdinal %5d:\t%08x\n", i+1, exp);
		}
	}

	// Important. Don't change output format of following inport info
	// because this is relied on by tools used by "Symbian Signed".
	if((aDumpFlags&EDumpImports) && iOrigHdr->iImportOffset)
	{
		const E32ImportSection* isection = (const E32ImportSection*)(iData + iOrigHdr->iImportOffset);
		TUint* iat = (TUint*)((TUint8*)iData + iOrigHdr->iCodeOffset + iOrigHdr->iTextSize);
		PrintString("\nIdata\tSize=%08x\n", isection->iSize);
		PrintString("Offset of import address table (relative to code section): %08x\n", iOrigHdr->iTextSize);
		TInt d;
		const E32ImportBlock* b = (const E32ImportBlock*)(isection + 1);
		for (d=0; d<iOrigHdr->iDllRefTableCount; d++)
		{
			char* dllname = iData + iOrigHdr->iImportOffset + b->iOffsetOfDllName;
			TInt n = b->iNumberOfImports;
			PrintString("%d imports from %s\n", b->iNumberOfImports, dllname);
			const TUint* p = b->Imports();
			TUint impfmt = iOrigHdr->ImportFormat();
			if (impfmt == KImageImpFmt_ELF)
			{
				while (n--)
				{
					TUint impd_offset = *p++;
					TUint impd = *(TUint*)(iData + iOrigHdr->iCodeOffset + impd_offset);
					TUint ordinal = impd & 0xffff;
					TUint offset = impd >> 16;
				
					if (offset)
						PrintString("%10d offset by %d\n", ordinal, offset);
					else
						PrintString("%10d\n", ordinal);
				}
			}
			else
			{
				while (n--)
					PrintString("\t%d\n", *iat++);
			}
			b = b->NextBlock(impfmt);
		}
	}
	if((aDumpFlags & EDumpSymbols) && (iOrigHdr->iFlags & KImageNmdExpData))
	{
		TUint* aExpTbl = (TUint*)(iData + iOrigHdr->iExportDirOffset);
		TUint* aZeroethOrd = aExpTbl - 1;

		E32EpocExpSymInfoHdr *aSymInfoHdr = (E32EpocExpSymInfoHdr*)(iData + \
					iOrigHdr->iCodeOffset + \
					*aZeroethOrd - iOrigHdr->iCodeBase ) ;
		DumpSymbolInfo(aSymInfoHdr);
	}
}

void E32ImageFile::DumpSymbolInfo(E32EpocExpSymInfoHdr *aSymInfoHdr)
{
	if(!aSymInfoHdr)
		return;
	char	*aSymTblBase = (char*)aSymInfoHdr;
	TUint	*aSymAddrTbl;
	char	*aSymNameTbl;

	char *aStrTable = aSymTblBase + aSymInfoHdr->iStringTableOffset;
	aSymAddrTbl = (TUint*)(aSymTblBase + aSymInfoHdr->iSymbolTblOffset);
	aSymNameTbl = (char*)(aSymAddrTbl + aSymInfoHdr->iSymCount);
	
	int aIdx;
	char *aSymName;

	PrintString("\n\n\t\tSymbol Info\n");
	if(aSymInfoHdr->iSymCount)
	{
		PrintString("0x%x Symbols exported\n",aSymInfoHdr->iSymCount);
		PrintString("  Addr\t\tName\n");
		PrintString("----------------------------------------\n");
		TUint aNameOffset = 0;
		for(aIdx=0;aIdx<aSymInfoHdr->iSymCount ; aIdx++)
		{
			if(aSymInfoHdr->iFlags & 1)
			{
				TUint32* aOff = ((TUint32*)aSymNameTbl+aIdx);
				aNameOffset = (*aOff) << 2;
				aSymName = aStrTable + aNameOffset;
			}
			else
			{
				TUint16* aOff = ((TUint16*)aSymNameTbl+aIdx);
				aNameOffset = (*aOff) << 2;
				aSymName = aStrTable + aNameOffset;
			}
			PrintString("0x%08x \t%s\t\n",aSymAddrTbl[aIdx], aSymName);
		}
	}
	else
	{
		PrintString("No Symbol exported\n");
	}
	PrintString("\n\n");

	if(aSymInfoHdr->iDllCount)
	{
		// The import table orders the dependencies alphabetically...
		// We need to list out in the link order...
		PrintString("%d Static dependencies found\n", aSymInfoHdr->iDllCount);
		TUint* aDepTbl = (TUint*)((char*)aSymInfoHdr + aSymInfoHdr->iDepDllZeroOrdTableOffset);
		TUint* aDepOffset =  (TUint*)((char*)aDepTbl - iData);

		const E32ImportSection* isection = (const E32ImportSection*)(iData + iOrigHdr->iImportOffset);
		
		TInt d;

		/* The import table has offsets to the location (in code section) where the
		 * import is required. For dependencies pointed by 0th ordinal, this offset
		 * must be same as the offset of the dependency table entry (relative to 
		 * the code section).
		 */
		bool aZerothFound;
		for(int aDep = 0; aDep < aSymInfoHdr->iDllCount; aDep++)
		{
			const E32ImportBlock* b = (const E32ImportBlock*)(isection + 1);
			aZerothFound = false;
			for (d=0; d<iOrigHdr->iDllRefTableCount; d++)
			{
				char* dllname = iData + iOrigHdr->iImportOffset + b->iOffsetOfDllName;
				TInt n = b->iNumberOfImports;

				const TUint* p = b->Imports()+ (n - 1);//start from the end of the import table
				TUint impfmt = iOrigHdr->ImportFormat();
				if (impfmt == KImageImpFmt_ELF)
				{
					while (n--)
					{
						TUint impd_offset = *p--;
						TUint impd = *(TUint*)(iData + iOrigHdr->iCodeOffset + impd_offset);
						TUint ordinal = impd & 0xffff;
					
						if (ordinal == 0 )
						{
							if( impd_offset == ((TUint)aDepOffset - iOrigHdr->iCodeOffset))
							{
								/* The offset in import table is same as the offset of this 
								 * dependency entry
								 */
								PrintString("\t%s\n", dllname);
								aZerothFound = true;
							}
							break;
						}
					}
				}
				if(aZerothFound)
					break;

				b = b->NextBlock(impfmt);
			}
			if(!aZerothFound)
			{
				PrintString("!!Invalid dependency listed at %d\n",aDep );
			}

			aDepOffset++;
		}
	}
}