diff -r 000000000000 -r a41df078684a kernel/eka/include/drivers/rm_debug_driver.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/kernel/eka/include/drivers/rm_debug_driver.h Mon Oct 19 15:55:17 2009 +0100 @@ -0,0 +1,197 @@ +// Copyright (c) 2004-2009 Nokia Corporation and/or its subsidiary(-ies). +// All rights reserved. +// This component and the accompanying materials are made available +// under the terms of the License "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: +// + + + +/** + @file + @internalTechnology + @released +*/ + +#ifndef __RM_DEBUG_DRIVER_H__ +#define __RM_DEBUG_DRIVER_H__ + +#include "d_rmd_stepping.h" +#include "d_rmd_breakpoints.h" +#include "d_driver_event_info.h" + +// From mmboot.h header +const TLinAddr KDataSectionEnd =0x40000000u; +const TLinAddr KRomLinearBase =0xF8000000u; + + +#define ROM_LINEAR_BASE KRomLinearBase + +// Result checking +#define ReturnIfError(x) { TInt y = x; if (KErrNone != y) return y; } + +// +// class DRM_DebugDriverFactory +// +class DRM_DebugDriverFactory : public DLogicalDevice +{ +public: + + DRM_DebugDriverFactory(); + virtual TInt Install(); + virtual void GetCaps(TDes8& aDes) const; + virtual TInt Create(DLogicalChannelBase*& aChannel); +}; + +class DRM_DebugEventHandler; +// +// DRM_DebugChannel +// +class DRM_DebugChannel : public DLogicalChannel +{ +public: + + DRM_DebugChannel(DLogicalDevice* aLogicalDevice); + ~DRM_DebugChannel(); + + virtual TInt DoCreate(TInt aUnit, const TDesC* anInfo, const TVersion& aVer); + virtual void HandleMsg(TMessageBase* aMsg); + virtual TInt SendMsg(TMessageBase* aMsg); + TInt SendRequest(TMessageBase* aMsg); + + //called from the event handler + TBool RemoveProcess(TAny* a1, TAny* a2); + TBool StartThread(TAny* a1, TAny* a2); + TBool AddLibrary(TAny* a1, TAny* a2); + TBool RemoveLibrary(TAny* a1, TAny* a2); + TBool HandleEventKillThread(TAny* a1, TAny* a2); + TBool HandleSwException(TAny* a1, TAny* a2); + TBool HandleHwException(TAny* a1, TAny* a2); + TBool HandleUserTrace(TAny* a1, TAny* a2); + TBool HandleUnsupportedEvent(TAny* a1, TAny* a2) { return EFalse; } + TBool HandleAddProcessEvent(TAny* a1, TAny* a2); + TBool HandleRemoveProcessEvent(TAny* a1, TAny* a2); + + // Used to be able to signal events to the DSS + DThread* ClientThread(void) {return iClientThread; }; + +protected: + virtual void DoCancel(TInt aReqNo); + virtual void DoRequest(TInt aReqNo, TRequestStatus* aStatus, TAny* a1, TAny* a2); + virtual TInt DoControl(TInt aFunction, TAny *a1, TAny *a2); + +private: + TInt PreAsyncGetValue(Debug::TEventInfo* aValue, TRequestStatus* aStatus); + TInt CreateDfcQ(); + void DestroyDfcQ(); + TBool HandleInvalidOpCodeException(TDriverEventInfo& aEventInfo, DThread* aCurrentThread); + + TInt SetBreak(TSetBreakInfo* aBreakInfo); + TInt StepRange(DThread* aThread, TRM_DebugStepInfo* aStepInfo); + TInt ReadMemory(DThread* aThread, TRM_DebugMemoryInfo* aMemoryInfo); + TInt WriteMemory(DThread* aThread, TRM_DebugMemoryInfo* aMemoryInfo); + TInt ReadRegistersLegacy(DThread* aThread, TRM_DebugRegisterInfo* aRegisterInfo); + TInt WriteRegistersLegacy(DThread* aThread, const TRM_DebugRegisterInfo* aRegisterInfo); + TInt ReadRegisters(DThread* aThread, TRM_DebugRegisterInformation* aRegisterInfo) const; + TInt WriteRegisters(DThread* aThread, TRM_DebugRegisterInformation* aRegisterInfo) const; + TInt GetProcessInfo(TInt aIndex, TRM_DebugTaskInfo* aTaskInfo); + TInt GetThreadInfo(TInt aIndex, TRM_DebugTaskInfo* aTaskInfo); + TInt GetList(TListInformation* aListInformation) const; + + TInt Step(const TUint32 aThreadId, const TUint32 aNumSteps); + TInt KillProcess(const TUint32 aProcessId, const TInt aReason); + + //Crash Flash + TInt ReadCrashLog(TFlashInfo* aBuffer); + TInt WriteCrashLog(TFlashInfo* aBuffer) const; + TInt EraseCrashLog(); + + // Stop/go + TInt DoSuspendThread(DThread *aThread); + TInt DoResumeThread(DThread *aThread); + TInt DoStepRange(DThread *aThread, const TUint32 aStartAddress, const TUint32 aStopAddress, TBool aStepInto, TBool aResumeOnceOutOfRange, const TUint32 aNumSteps, TBool aUserRequest = EFalse); + TInt DoReadMemory(const DThread *aThread, const TUint32 aAddress, const TUint32 aLength, TDes8 &aData) const; + TInt DoWriteMemory(DThread *aThread, const TUint32 aAddress, const TUint32 aLength, TDes8 &aData); + TInt DoReadRegisters(DThread *aThread, const TInt16 aFirstRegister, const TInt16 aLastRegister, TDes8 &aValues); + TInt DoReadRegisters(DThread *aThread, const TDesC8 &aRegisterIds, TDes8 &aRegisterValues, TDes8 &aRegisterFlags) const; + TInt DoWriteRegisters(DThread *aThread, const TInt16 aFirstRegister, const TInt16 aLastRegister, TDesC8 &aValues); + TInt DoWriteRegisters(DThread *aThread, const TDesC8 &aRegisterIds, TDesC8 &aRegisterValues, TDes8 &aRegisterFlags) const; + TInt DoGetProcessInfo(const TInt aIndex, TRM_DebugTaskInfo *aInfo); + TInt DoGetThreadInfo(const TInt aIndex, TRM_DebugTaskInfo *aInfo); + TBool DoSecurityCheck(); + + TInt TryToReadMemory(const DThread *aThread, const TAny *aSrc, TAny *aDest, const TUint32 aLength) const; + TInt TryToWriteMemory(const DThread *aThread, TAny *aDest, const TAny *aSrc, const TUint32 aLength); + TInt32 ReadRegister(DThread *aThread, TInt aNum); + TInt32 ReadDebugRegisterValue(DThread *aThread, const Debug::TRegisterInfo aDebugRegisterId, T4ByteRegisterValue &aValue) const; + TInt32 ReadKernelRegisterValue(DThread *aThread, const TArmReg aKernelRegisterId, T4ByteRegisterValue &aValue) const; + + void NotifyEvent(const TDriverEventInfo& aEventInfo); + + TInt GetTRegisterInfo(const TDesC8 &aRegisterIds, const TUint aIndex, Debug::TRegisterInfo &aValue) const; + TInt GetDebugRegisterId(const TArmReg aKernelRegister, Debug::TRegisterInfo& aDebugRegister) const; + TInt GetKernelRegisterId(const Debug::TRegisterInfo aDebugRegister, TArmReg& aKernelRegister) const; + TBool GetFlagAtOffset(const TUint32 aFlags, const TArmReg aIndex) const; + + TInt AllocAndReadDes(DThread *aThread, const TDesC8& aSrcDes, TPtr8& aDestDes, const TBool aReadFromClient=ETrue, const TUint aOffset=0) const; + + TInt AttachProcess(TAny* a1, TAny* a2); + TInt DetachProcess(TAny* a1, TAny* a2); + TInt DetachAgent(TAny* a1, TAny* a2); + TInt SetEventAction(TAny* a1, TAny* a2); + TBool CheckSuspended(const DThread *aThread) const; + + // Needed so moved functions can access iBreakpoint list and related functions + friend class D_RMD_Breakpoints; + // Needed so moved functions can access stepping functionality + friend class DRMDStepping; + + // helper function was previously in rm_debug_kerneldriver.cpp + inline TInt Bitcount(TUint32 val) + { + TInt nbits; + + for (nbits = 0; val != 0; nbits++) + { + val &= val - 1; // delete rightmost 1-bit in val + } + + return nbits; + } + + // Security critical - this returns whether the specified process is debuggable or not + TInt IsDebuggable(const TUint32 aProcessId); + +private: + DThread* iClientThread; + DRM_DebugEventHandler* iEventHandler; + + TUint32 iExcludedROMAddressStart; + TUint32 iExcludedROMAddressEnd; + + TUint32 iPageSize; + + RArray iDebugProcessList; //processes that we are debugging + + D_RMD_Breakpoints* iBreakManager; // new D_RMD_Breakpoints + + DRMDStepping* iStepper; // new DRMDStepping + + DSemaphore* iStepLock; // Synchronisation for stepping code. + + TDynamicDfcQue* iDfcQ; + + TBool iInitialisedCodeModifier; // Ensures we control its lifetime + + TClientDataRequest* iAsyncGetValueRequest; +}; + +#endif //__RM_DEBUG_DRIVER_H__