|
|
// shapi.h - Public API to the Symbol Handler
//
// This file contains all types and APIs that are defined by
// the Symbol Handler and are publicly accessible by other
// components.
//
// Before including this file, you must include cvtypes.h.
// The master copy of this file resides in the CVINC project.
// All Microsoft projects are required to use the master copy without
// modification. Modification of the master version or a copy
// without consultation with all parties concerned is extremely
// risky.
#ifndef _VC_VER_INC
#include "..\include\vcver.h"
#endif
#include <tchar.h>
#ifndef SH_API
#define SH_API
#define DECL_STR(n, v, s) n = v,
typedef enum { // Error returns from some SH functions
#include "sherror.h"
} SHE; #undef DECL_STR
enum { sopNone = 0, sopData = 1, sopStack = 2, sopReg = 4, sopLab = 8, sopFcn = 16, sopExact = 32 }; typedef short SOP; // Symbol OPtions
typedef enum { fstNone, fstSymbol, fstPublic } FST; // Function Symbol Type
typedef enum { fcdUnknown, fcdNear, fcdFar, fcdData } FCD; // Function Call Distance (near/far/unknown)
typedef enum { fptUnknown, fptPresent, fptOmitted } FPT; // Frame Pointer Type
typedef struct _ODR { FST fst; FCD fcd; FPT fpt; WORD cbProlog; DWORD dwDeltaOff; LSZ lszName; } ODR; // OSDebug Return type
typedef ODR *LPODR;
typedef enum { astNone, astAddress, astRegister, astBaseOff } AST; // Assembler symbol return Types
typedef struct _ASR { AST ast; union { struct { FCD fcd; ADDR addr; }; WORD ireg; OFFSET off; }; } ASR; // Assembler Symbol Return structure
typedef ASR *LPASR;
typedef HEMI SHEMI; typedef BOOL SHFLAG; // A TRUE/FALSE flag var
typedef SHFLAG * PSHFLAG; typedef SEGMENT SHSEG; // A segment/selector value
typedef UOFFSET SHOFF; // An offset value
typedef void * HVOID; // Generic handle type
typedef HIND HMOD; // A module handle
typedef HIND HGRP; // A group handle (sub group of module
// currently either a seg or filename)
typedef HVOID HPROC; // A handle to a procedure
typedef HVOID HBLK; // A handle to a block.
typedef HVOID HSF; // A handle to source file table
typedef HIND HEXE; // An Executable file handle
typedef HVOID HTYPE; // A handle to a type
typedef HVOID HSYM; // A handle to a symbol
typedef HIND HPDS; // A handle to a process
typedef HSYM * PHSYM;
typedef CV_typ_t THIDX;
typedef struct CXT { ADDR addr; HMOD hMod; HGRP hGrp; HPROC hProc; HBLK hBlk; } CXT; // General Symbol context pkt
typedef CXT *PCXT;
typedef struct CXF { CXT cxt; #if 0
FRAME Frame; #else
HFRAME hFrame; #endif
} CXF; // Symbol context pkt locked to a frame ptr
typedef CXF *PCXF;
typedef enum { SHFar, SHNear } SHCALL;
typedef struct SHREG { DWORD hReg; union { unsigned char Byte1; struct { unsigned short Byte2; unsigned short Byte2High; }; struct { unsigned long Byte4; unsigned long Byte4High; }; double Byte8; unsigned __int64 Byte8i; FLOAT10 Byte10; }; } SHREG; typedef SHREG *PSHREG;
typedef struct _SLP { ADDR addr; SHOFF cb; } SLP; // Source Line Pair (used by SLCAddrFromLine)
typedef SLP * LPSLP;
// structure defining parameters of symbol to be searched for. The address
// of this structure is passed on the the EE's symbol compare routine. Any
// additional data required by the EE's routine must follow this structure.
typedef struct _SSTR { // string with length byte and pointer to data
LPB lpName; // pointer to the string itself
unsigned char cb; // length byte
unsigned char searchmask; // mask to control symbol searching
unsigned short symtype; // symbol types to be checked
unsigned char * pRE; // pointer to regular expression
} SSTR; typedef SSTR *LPSSTR;
#define SSTR_proc 0x0001 // compare only procs with correct type
#define SSTR_data 0x0002 // compare only global data with correct type
#define SSTR_RE 0x0004 // compare using regular expression
#define SSTR_NoHash 0x0008 // do a linear search of the table
#define SSTR_symboltype 0x0010 // pass only symbols of symtype to the
// comparison function.
#define SSTR_FuzzyPublic 0x0020 // Ignore leading _, .. or trailing @xxx
#define SHpCXTFrompCXF(a) (&((a)->cxt))
//#define SHpFrameFrompCXF(a) (&(a)->Frame)
#define SHhFrameFrompCXF(a) ((a)->hFrame)
#define SHHMODFrompCXT(a) ((a)->hMod)
#define SHHPROCFrompCXT(a) ((a)->hProc)
#define SHHBLKFrompCXT(a) ((a)->hBlk)
#define SHpADDRFrompCXT(a) (&((a)->addr))
#define SHPAddrFromPCxf(a) (SHpADDRFrompCXT(SHpCXTFrompCXF(a)))
#define SHIsCXTMod(a) ((a)->hMod && !(a)->hProc && !(a)->hBlk)
#define SHIsCXTProc(a) ((a)->hMod && (a)->hProc && !(a)->hBlk)
#define SHIsCXTBlk(a) ((a)->hMod && (a)->hProc && (a)->hBlk)
#define SHHGRPFrompCXT(a) ((a)->hGrp)
// Used by comparison functions
//
// Structure to cross-check validity of .dbg file
// against the image.
//
// The values are returned to the caller so that the
// caller can format the error message.
typedef struct _VLDCHK { //
// Values from image
DWORD ImgTimeDateStamp; DWORD ImgCheckSum; //
// Values from sym file
DWORD SymTimeDateStamp; DWORD SymCheckSum; } VLDCHK; typedef VLDCHK *LPVLDCHK; typedef VLDCHK *PVLDCHK;
// comparison prototype
typedef SHFLAG (FAR PASCAL *PFNCMP) (HVOID, HVOID, LSZ, SHFLAG); typedef SHE (FAR PASCAL *PFNVALIDATEEXE) (INT, PVLDCHK); typedef BOOL (FAR PASCAL *PFNVALIDATEDEBUGINFOFILE) (LPCSTR szFile, ULONG * errcode );
#define LPFNSYM WINAPI *
#define LPFNSYMC CDECL *
#if 0
typedef struct omap_tag { DWORD rva; DWORD rvaTo; } OMAP, *POMAP, *LPOMAP; #else
typedef POMAP LPOMAP; #endif
typedef struct { DWORD Offset; DWORD Size; DWORD Flags; } SECSTART, *LPSECSTART;
typedef struct _tagDEBUGDATA { union { PIMAGE_RUNTIME_FUNCTION_ENTRY lpRtf; // Runtime function table - fpo or pdata
PFPO_DATA lpFpo; }; DWORD cRtf; // Count of rtf entries
PIMAGE_RUNTIME_FUNCTION_ENTRY lpOriginalRtf; // Original pdata address
LPOMAP lpOmapFrom; // Omap table - From Source
DWORD cOmapFrom; // Count of omap entries - From Source
LPOMAP lpOmapTo; // Omap table - To Source
DWORD cOmapTo; // Count of omap entries - To Source
LPSECSTART lpSecStart; // Original section table (pre-Lego)
// SHE she; // Remember any load errors
} DEBUGDATA, *LPDEBUGDATA;
#if 0
// get rid of this for compatibility with pdb.h
typedef struct _tagSEARCHDEBUGINFO { DWORD cb; // doubles as version detection
BOOL fMainDebugFile; // indicates "core" or "ancilliary" file
// eg: main.exe has main.pdb and foo.lib->foo.pdb
LSZ szMod; // exe/dll
LSZ szLib; // lib if appropriate
LSZ szObj; // object file
LSZ * rgszTriedThese; // list of ones that were tried,
// NULL terminated list of LSZ's
_TCHAR szValidatedFile[_MAX_PATH]; // output of validated filename,
PFNVALIDATEDEBUGINFOFILE pfnValidateDebugInfoFile; // validation function
} SEARCHDEBUGINFO, *PSEARCHDEBUGINFO; #endif
typedef struct _KNF { int cb;
PVOID (LPFNSYM lpfnMHAlloc) (UINT); PVOID (LPFNSYM lpfnMHRealloc) (PVOID, UINT); VOID (LPFNSYM lpfnMHFree) (PVOID); PVOID (LPFNSYM lpfnMHAllocHuge) (LONG, UINT); VOID (LPFNSYM lpfnMHFreeHuge) (PVOID);
HDEP (LPFNSYM lpfnMMAllocHmem) (UINT); VOID (LPFNSYM lpfnMMFreeHmem) (HDEP); PVOID (LPFNSYM lpfnMMLock) (HDEP); VOID (LPFNSYM lpfnMMUnlock) (HDEP);
HLLI (LPFNSYM lpfnLLInit) (DWORD, LLF, LPFNKILLNODE, LPFNFCMPNODE); HLLE (LPFNSYM lpfnLLCreate) (HLLI); VOID (LPFNSYM lpfnLLAdd) (HLLI, HLLE); VOID (LPFNSYM lpfnLLAddHead) (HLLI, HLLE); VOID (LPFNSYM lpfnLLInsert) (HLLI, HLLE, DWORD); BOOL (LPFNSYM lpfnLLDelete) (HLLI, HLLE); BOOL (LPFNSYM lpfnLLRemove) (HLLI, HLLE); DWORD (LPFNSYM lpfnLLDestroy) (HLLI); HLLE (LPFNSYM lpfnLLNext) (HLLI, HLLE); HLLE (LPFNSYM lpfnLLFind) (HLLI, HLLE, PVOID, DWORD); HLLE (LPFNSYM lpfnLLLast) (HLLI); DWORD (LPFNSYM lpfnLLSize) (HLLI); PVOID (LPFNSYM lpfnLLLock) (HLLE); VOID (LPFNSYM lpfnLLUnlock) (HLLE);
BOOL (LPFNSYM lpfnLBPrintf) (LPCH, LPCH, DWORD); BOOL (LPFNSYM lpfnLBQuit) (DWORD);
UINT (LPFNSYM lpfnSYOpen) (LSZ); VOID (LPFNSYM lpfnSYClose) (UINT); UINT (LPFNSYM lpfnSYReadFar) (UINT, LPB, UINT); LONG (LPFNSYM lpfnSYSeek) (UINT, LONG, UINT); int (LPFNSYM lpfnSYFixupAddr) (PADDR); int (LPFNSYM lpfnSYUnFixupAddr)(PADDR); UINT (LPFNSYM lpfnSYProcessor) (DWORD);
// Added/Changed for NT merge.
// VOID (LPFNSYM lpfn_searchenv) (LSZ, LSZ, LSZ);
// UINT (LPFNSYMC lpfnsprintf) (LSZ, LSZ, ...);
// VOID (LPFNSYM lpfn_splitpath) (LSZ, LSZ, LSZ, LSZ, LSZ);
// LSZ (LPFNSYM lpfn_fullpath) (LSZ, LSZ, UINT);
// VOID (LPFNSYM lpfn_makepath) (LSZ, LSZ, LSZ, LSZ, LSZ);
// UINT (LPFNSYM lpfnstat) (LSZ, LPCH);
LONG (LPFNSYM lpfnSYTell) (UINT); UINT (LPFNSYM lpfnSYFindExeFile) (LSZ, LSZ, UINT, PVLDCHK, PFNVALIDATEEXE, SHE *); VOID (LPFNSYM lpfnLoadedSymbols) (SHE, LSZ); BOOL (LPFNSYM lpfnSYGetDefaultShe) (LSZ, SHE *);
// Added for separate type pool work
BOOL (LPFNSYM pfnSYFindDebugInfoFile) ( PSEARCHDEBUGINFO ); BOOL (WINAPI * lpfnGetRegistryRoot) ( LPTSTR, LPDWORD );
#ifdef NT_BUILD_ONLY
// Added for WinDbg back port
BOOL (LPFNSYM lpfnSetProfileString)(LPCSTR, LPCSTR); BOOL (LPFNSYM lpfnGetProfileString)(LPCSTR, LPSTR, ULONG, ULONG *);
#endif
} KNF; // KerNel Functions exported to the Symbol Handler
typedef KNF *LPKNF;
typedef struct _SHF { int cb; HPDS (LPFNSYM pSHCreateProcess) (VOID); VOID (LPFNSYM pSHSetHpid) (HPID); BOOL (LPFNSYM pSHDeleteProcess) (HPDS); HPDS (LPFNSYM pSHChangeProcess) (HPDS); SHE (LPFNSYM pSHAddDll) (LSZ, BOOL); // Changed for NT
SHE (LPFNSYM pSHAddDllsToProcess) (VOID); SHE (LPFNSYM pSHLoadDll) (LSZ, BOOL); VOID (LPFNSYM pSHUnloadDll) (HEXE); UOFFSET (LPFNSYM pSHGetDebugStart) (HSYM); LSZ (LPFNSYM pSHGetSymName) (HSYM, LSZ); BOOL (LPFNSYM pSHAddrFromHsym) (PADDR, HSYM); // Changed for NT
HMOD (LPFNSYM pSHHModGetNextGlobal) (HEXE *, HMOD); int (LPFNSYM pSHModelFromAddr) (PADDR, LPW, LPB, UOFFSET *); int (LPFNSYM pSHPublicNameToAddr) (PADDR, PADDR, LSZ, PFNCMP); LSZ (LPFNSYM pSHGetSymbol) (LPADDR, LPADDR, SOP, LPODR); BOOL (LPFNSYM pSHGetPublicAddr) (PADDR, LSZ); BOOL (LPFNSYM pSHIsLabel) (HSYM);
VOID (LPFNSYM pSHSetDebuggeeDir) (LSZ); // VOID (LPFNSYM pSHSetUserDir) (LSZ); // Deleted for NT
BOOL (LPFNSYM pSHAddrToLabel) (PADDR, LSZ);
int (LPFNSYM pSHGetSymLoc) (HSYM, LSZ, UINT, PCXT); BOOL (LPFNSYM pSHFIsAddrNonVirtual) (PADDR); BOOL (LPFNSYM pSHIsFarProc) (HSYM);
HEXE (LPFNSYM pSHGetNextExe) (HEXE); HEXE (LPFNSYM pSHHexeFromHmod) (HMOD); HMOD (LPFNSYM pSHGetNextMod) (HEXE, HMOD); PCXT (LPFNSYM pSHGetCxtFromHmod) (HMOD, PCXT); PCXT (LPFNSYM pSHSetCxt) (PADDR, PCXT); PCXT (LPFNSYM pSHSetCxtMod) (PADDR, PCXT); HSYM (LPFNSYM pSHFindNameInGlobal) (HSYM, PCXT, LPSSTR, SHFLAG, PFNCMP, PCXT ); HSYM (LPFNSYM pSHFindNameInContext) (HSYM, PCXT, LPSSTR, SHFLAG, PFNCMP, PCXT ); HSYM (LPFNSYM pSHGoToParent) (PCXT, PCXT); HSYM (LPFNSYM pSHHsymFromPcxt) (PCXT); HSYM (LPFNSYM pSHNextHsym) (HMOD, HSYM); PCXF (LPFNSYM pSHGetFuncCXF) (PADDR, PCXF); LPCH (LPFNSYM pSHGetModName) (HMOD); LPCH (LPFNSYM pSHGetExeName) (HEXE); HEXE (LPFNSYM pSHGethExeFromName) (LPCH); UOFF32 (LPFNSYM pSHGetNearestHsym) (PADDR, HMOD, int, PHSYM); SHFLAG (LPFNSYM pSHIsInProlog) (PCXT); SHFLAG (LPFNSYM pSHIsAddrInCxt) (PCXT, PADDR); SHFLAG (LPFNSYM pSHCompareRE) (LPCH, LPCH, BOOL); BOOL (LPFNSYM pSHFindSymbol) (LSZ, PADDR, LPASR); UOFF32 (LPFNSYM pPHGetNearestHsym) (PADDR, HEXE, PHSYM); HSYM (LPFNSYM pPHFindNameInPublics) (HSYM, HEXE, LPSSTR, SHFLAG, PFNCMP); HTYPE (LPFNSYM pTHGetTypeFromIndex) (HMOD, THIDX); HTYPE (LPFNSYM pTHGetNextType) (HMOD, HTYPE); PVOID (LPFNSYM pSHLpGSNGetTable) (HEXE); BOOL (LPFNSYM pSHCanDisplay) (HSYM);
// Source Line handler API Exports
BOOL (LPFNSYM pSLLineFromAddr) (LPADDR, LPDWORD, SHOFF *, SHOFF *); BOOL (LPFNSYM pSLFLineToAddr) (HSF, DWORD, LPADDR, SHOFF *, DWORD *); LPCH (LPFNSYM pSLNameFromHsf) (HSF); LPCH (LPFNSYM pSLNameFromHmod) (HMOD, WORD); BOOL (LPFNSYM pSLFQueryModSrc) (HMOD); HMOD (LPFNSYM pSLHmodFromHsf) (HEXE, HSF); HSF (LPFNSYM pSLHsfFromPcxt) (PCXT); HSF (LPFNSYM pSLHsfFromFile) (HMOD, LSZ);
int (LPFNSYM pSLCAddrFromLine) (HEXE, HMOD, LSZ, WORD, LPSLP *); VOID (LPFNSYM pSHFree) (PVOID); VOID (LPFNSYM pSHUnloadSymbolHandler)(BOOL); // REVIEW: piersh
#ifdef NT_BUILD_ONLY
SHE (LPFNSYM pSHGetExeTimeStamp) (LPSTR, ULONG *); #else
SHE (LPFNSYM pSHGetExeTimeStamp) (LPSTR, ULONG* Time, ULONG* Check); #endif
VOID (LPFNSYM pSHPdbNameFromExe) (LSZ, LSZ, UINT); LPVOID (LPFNSYM pSHGetDebugData) (HEXE); BOOL (LPFNSYM pSHIsThunk) (HSYM); HSYM (LPFNSYM pSHFindSymInExe) (HEXE, LPSSTR, BOOL); HSYM (LPFNSYM pSHFindSLink32) (PCXT); BOOL (LPFNSYM pSHIsDllLoaded) (HEXE);
// Entries added for NT work.
LSZ (LPFNSYM pSHGetModule) (PADDR, LSZ); PCXT (LPFNSYM pSHGetCxtFromHexe) (HEXE, PCXT); LPCH (LPFNSYM pSHGetModNameFromHexe) (HEXE); LPCH (LPFNSYM pSHGetSymFName) (HEXE); HEXE (LPFNSYM pSHGethExeFromModuleName) (LPCH); LSZ (LPFNSYM pSHLszGetErrorText) (SHE); BOOL (LPFNSYM pSHWantSymbols) (HEXE); HSYM (LPFNSYM pSHFindNameInTypes) ( PCXT, LPSSTR, SHFLAG, PFNCMP, PCXT );
// Entries added for separate type pools work
BOOL (LPFNSYM pTHAreTypesEqual) (HMOD, CV_typ_t, CV_typ_t);
// New work
BOOL (LPFNSYM pSHSymbolsLoaded)(HEXE, SHE *); BOOL (LPFNSYM pSHSymbolsLoadError)(HEXE, SHE *); SHE (LPFNSYM pSHUnloadSymbols)(HEXE);
} SHF; // Symbol Handler Functions
typedef SHF *LPSHF;
// FNSHINIT is the prototype for the SHInit function
typedef BOOL EXPCALL FNSHINIT(LPSHF *, LPKNF);
typedef FNSHINIT * LPFNSHINIT; typedef FNSHINIT * PFNSHINIT;
typedef BOOL (* LPFNSHUNINIT)(VOID); typedef BOOL (* LPFNSHSTARTBACKGROUND)(VOID); typedef BOOL (* LPFNSHSTOPBACKGROUND)(VOID);
// This is the only SH function that's actually exported from the DLL
FNSHINIT SHInit;
#endif // SH_API
|