485 lines
16 KiB
C
485 lines
16 KiB
C
/*
|
|
* Debugger definitions
|
|
*
|
|
* Copyright 1995 Alexandre Julliard
|
|
*/
|
|
|
|
#ifndef __WINE_DEBUGGER_H
|
|
#define __WINE_DEBUGGER_H
|
|
|
|
#include <sys/types.h> /* u_long ... */
|
|
#include <assert.h>
|
|
#include "windef.h"
|
|
#include "winbase.h"
|
|
#include "wine/exception.h"
|
|
|
|
#ifdef __i386__
|
|
#define STEP_FLAG 0x00000100 /* single step flag */
|
|
#define V86_FLAG 0x00020000
|
|
#endif
|
|
|
|
#define SYM_FUNC 0x0
|
|
#define SYM_DATA 0x1
|
|
#define SYM_WIN32 0x2
|
|
#define SYM_WINE 0x4
|
|
#define SYM_INVALID 0x8
|
|
#define SYM_TRAMPOLINE 0x10
|
|
#define SYM_STEP_THROUGH 0x20
|
|
|
|
enum debug_type {DT_BASIC, DT_CONST, DT_POINTER, DT_ARRAY, DT_STRUCT, DT_ENUM, DT_TYPEDEF, DT_FUNC, DT_BITFIELD};
|
|
|
|
|
|
/*
|
|
* Return values for DEBUG_CheckLinenoStatus. Used to determine
|
|
* what to do when the 'step' command is given.
|
|
*/
|
|
#define FUNC_HAS_NO_LINES (0)
|
|
#define NOT_ON_LINENUMBER (1)
|
|
#define AT_LINENUMBER (2)
|
|
#define FUNC_IS_TRAMPOLINE (3)
|
|
|
|
/*
|
|
* For constants generated by the parser, we use this datatype
|
|
*/
|
|
extern struct datatype * DEBUG_TypeShortUInt;
|
|
extern struct datatype * DEBUG_TypeInt;
|
|
extern struct datatype * DEBUG_TypeIntConst;
|
|
extern struct datatype * DEBUG_TypeUSInt;
|
|
extern struct datatype * DEBUG_TypeString;
|
|
|
|
typedef struct
|
|
{
|
|
DWORD seg; /* 0xffffffff means current default segment (cs or ds) */
|
|
DWORD off;
|
|
} DBG_ADDR;
|
|
|
|
#define DV_TARGET 0xF00D
|
|
#define DV_HOST 0x50DA
|
|
|
|
typedef struct
|
|
{
|
|
struct datatype* type;
|
|
int cookie; /* DV_??? */
|
|
DBG_ADDR addr;
|
|
} DBG_VALUE;
|
|
|
|
struct list_id
|
|
{
|
|
char * sourcefile;
|
|
int line;
|
|
};
|
|
|
|
struct wine_lines {
|
|
unsigned long line_number;
|
|
DBG_ADDR pc_offset;
|
|
};
|
|
|
|
struct symbol_info
|
|
{
|
|
struct name_hash * sym;
|
|
struct list_id list;
|
|
};
|
|
|
|
typedef struct wine_lines WineLineNo;
|
|
|
|
/*
|
|
* This structure holds information about stack variables, function
|
|
* parameters, and register variables, which are all local to this
|
|
* function.
|
|
*/
|
|
struct wine_locals {
|
|
unsigned int regno:8; /* For register symbols */
|
|
signed int offset:24; /* offset from esp/ebp to symbol */
|
|
unsigned int pc_start; /* For RBRAC/LBRAC */
|
|
unsigned int pc_end; /* For RBRAC/LBRAC */
|
|
char * name; /* Name of symbol */
|
|
struct datatype * type; /* Datatype of symbol */
|
|
};
|
|
|
|
typedef struct wine_locals WineLocals;
|
|
|
|
enum exec_mode
|
|
{
|
|
EXEC_CONT, /* Continuous execution */
|
|
EXEC_PASS, /* Continue, passing exception to app */
|
|
EXEC_STEP_OVER, /* Stepping over a call to next source line */
|
|
EXEC_STEP_INSTR, /* Step to next source line, stepping in if needed */
|
|
EXEC_STEPI_OVER, /* Stepping over a call */
|
|
EXEC_STEPI_INSTR, /* Single-stepping an instruction */
|
|
EXEC_FINISH, /* Step until we exit current frame */
|
|
EXEC_STEP_OVER_TRAMPOLINE, /* Step over trampoline. Requires that
|
|
* we dig the real return value off the stack
|
|
* and set breakpoint there - not at the
|
|
* instr just after the call.
|
|
*/
|
|
EXEC_KILL /* terminate debugging session */
|
|
};
|
|
|
|
#define DBG_BREAK 0
|
|
#define DBG_WATCH 1
|
|
|
|
typedef struct
|
|
{
|
|
DBG_ADDR addr;
|
|
WORD enabled : 1,
|
|
type : 1,
|
|
is32 : 1,
|
|
refcount : 13;
|
|
WORD skipcount;
|
|
union {
|
|
struct {
|
|
BYTE opcode;
|
|
BOOL (*func)(void);
|
|
} b;
|
|
struct {
|
|
BYTE rw : 1,
|
|
len : 2;
|
|
BYTE reg;
|
|
DWORD oldval;
|
|
} w;
|
|
} u;
|
|
struct expr * condition;
|
|
} DBG_BREAKPOINT;
|
|
|
|
typedef struct tagDBG_THREAD {
|
|
struct tagDBG_PROCESS* process;
|
|
HANDLE handle;
|
|
DWORD tid;
|
|
LPVOID start;
|
|
LPVOID teb;
|
|
int wait_for_first_exception;
|
|
int dbg_mode;
|
|
enum exec_mode dbg_exec_mode;
|
|
int dbg_exec_count;
|
|
DBG_BREAKPOINT stepOverBP;
|
|
struct tagDBG_THREAD* next;
|
|
struct tagDBG_THREAD* prev;
|
|
} DBG_THREAD;
|
|
|
|
typedef struct tagDBG_PROCESS {
|
|
HANDLE handle;
|
|
DWORD pid;
|
|
DBG_THREAD* threads;
|
|
int num_threads;
|
|
unsigned continue_on_first_exception;
|
|
struct tagDBG_MODULE* modules;
|
|
unsigned long dbg_hdr_addr;
|
|
/*
|
|
* This is an index we use to keep track of the debug information
|
|
* when we have multiple sources. We use the same database to also
|
|
* allow us to do an 'info shared' type of deal, and we use the index
|
|
* to eliminate duplicates.
|
|
*/
|
|
int next_index;
|
|
struct tagDBG_PROCESS* next;
|
|
struct tagDBG_PROCESS* prev;
|
|
} DBG_PROCESS;
|
|
|
|
extern DBG_PROCESS* DEBUG_CurrProcess;
|
|
extern DBG_THREAD* DEBUG_CurrThread;
|
|
extern CONTEXT DEBUG_context;
|
|
|
|
#define DEBUG_READ_MEM(addr, buf, len) \
|
|
(ReadProcessMemory(DEBUG_CurrProcess->handle, (addr), (buf), (len), NULL))
|
|
|
|
#define DEBUG_WRITE_MEM(addr, buf, len) \
|
|
(WriteProcessMemory(DEBUG_CurrProcess->handle, (addr), (buf), (len), NULL))
|
|
|
|
#define DEBUG_READ_MEM_VERBOSE(addr, buf, len) \
|
|
(DEBUG_READ_MEM((addr), (buf), (len)) || (DEBUG_InvalLinAddr( addr ),0))
|
|
|
|
#define DEBUG_WRITE_MEM_VERBOSE(addr, buf, len) \
|
|
(DEBUG_WRITE_MEM((addr), (buf), (len)) || (DEBUG_InvalLinAddr( addr ),0))
|
|
|
|
typedef struct tagDBG_MODULE {
|
|
struct tagDBG_MODULE* next;
|
|
void* load_addr;
|
|
char* module_name;
|
|
char status;
|
|
char type;
|
|
short int dbg_index;
|
|
HMODULE handle;
|
|
void* extra_info;
|
|
} DBG_MODULE;
|
|
|
|
/* status field */
|
|
#define DM_STATUS_NEW 0
|
|
#define DM_STATUS_LOADED 1
|
|
#define DM_STATUS_ERROR 2
|
|
|
|
/* type field */
|
|
#define DM_TYPE_UNKNOWN 0
|
|
#define DM_TYPE_ELF 1
|
|
#define DM_TYPE_NE 2
|
|
#define DM_TYPE_PE 3
|
|
|
|
typedef struct {
|
|
DWORD val;
|
|
const char* name;
|
|
LPDWORD pval;
|
|
struct datatype* type;
|
|
} DBG_INTVAR;
|
|
|
|
#define OFFSET_OF(__c,__f) ((int)(((char*)&(((__c*)0)->__f))-((char*)0)))
|
|
|
|
/* debugger/break.c */
|
|
extern void DEBUG_SetBreakpoints( BOOL set );
|
|
extern void DEBUG_AddBreakpoint( const DBG_VALUE *addr, BOOL (*func)(void) );
|
|
extern void DEBUG_AddWatchpoint( const DBG_VALUE *addr, int is_write );
|
|
extern void DEBUG_DelBreakpoint( int num );
|
|
extern void DEBUG_EnableBreakpoint( int num, BOOL enable );
|
|
extern void DEBUG_InfoBreakpoints(void);
|
|
extern BOOL DEBUG_HandleTrap(void);
|
|
extern BOOL DEBUG_ShouldContinue( DWORD code, enum exec_mode mode, int * count );
|
|
extern void DEBUG_SuspendExecution( void );
|
|
extern enum exec_mode DEBUG_RestartExecution( enum exec_mode mode, int count );
|
|
extern BOOL DEBUG_IsFctReturn(void);
|
|
extern int DEBUG_AddBPCondition(int bpnum, struct expr * exp);
|
|
|
|
/* debugger/db_disasm.c */
|
|
extern void DEBUG_Disasm( DBG_ADDR *addr, int display );
|
|
|
|
/* debugger/dbg.y */
|
|
extern BOOL DEBUG_Main( BOOL is_debug, BOOL force, DWORD code );
|
|
extern void DEBUG_Exit( DWORD );
|
|
|
|
/* debugger/debug.l */
|
|
extern void flush_symbols(void);
|
|
|
|
/* debugger/display.c */
|
|
extern int DEBUG_DoDisplay(void);
|
|
extern int DEBUG_AddDisplay(struct expr * exp, int count, char format);
|
|
extern int DEBUG_DoDisplay(void);
|
|
extern int DEBUG_DelDisplay(int displaynum);
|
|
extern int DEBUG_InfoDisplay(void);
|
|
|
|
/* debugger/editline.c */
|
|
extern char * readline(const char *);
|
|
extern void add_history(char *);
|
|
|
|
/* debugger/expr.c */
|
|
extern void DEBUG_FreeExprMem(void);
|
|
struct expr * DEBUG_IntVarExpr(const char* name);
|
|
struct expr * DEBUG_SymbolExpr(const char * name);
|
|
struct expr * DEBUG_ConstExpr(int val);
|
|
struct expr * DEBUG_StringExpr(const char * str);
|
|
struct expr * DEBUG_SegAddr(struct expr *, struct expr *);
|
|
struct expr * DEBUG_USConstExpr(unsigned int val);
|
|
struct expr * DEBUG_BinopExpr(int oper, struct expr *, struct expr *);
|
|
struct expr * DEBUG_UnopExpr(int oper, struct expr *);
|
|
struct expr * DEBUG_StructPExpr(struct expr *, const char * element);
|
|
struct expr * DEBUG_StructExpr(struct expr *, const char * element);
|
|
struct expr * DEBUG_ArrayExpr(struct expr *, struct expr * index);
|
|
struct expr * DEBUG_CallExpr(const char *, int nargs, ...);
|
|
struct expr * DEBUG_TypeCastExpr(struct datatype *, struct expr *);
|
|
extern DBG_VALUE DEBUG_EvalExpr(struct expr *);
|
|
extern int DEBUG_DelDisplay(int displaynum);
|
|
extern struct expr * DEBUG_CloneExpr(const struct expr * exp);
|
|
extern int DEBUG_FreeExpr(struct expr * exp);
|
|
extern int DEBUG_DisplayExpr(const struct expr * exp);
|
|
|
|
/* debugger/external.c */
|
|
extern void DEBUG_ExternalDebugger(void);
|
|
|
|
/* debugger/hash.c */
|
|
extern struct name_hash * DEBUG_AddSymbol( const char *name,
|
|
const DBG_VALUE *addr,
|
|
const char *sourcefile,
|
|
int flags);
|
|
extern BOOL DEBUG_GetSymbolValue( const char * name, const int lineno,
|
|
DBG_VALUE *addr, int );
|
|
extern BOOL DEBUG_SetSymbolValue( const char * name, const DBG_VALUE *addr );
|
|
extern const char * DEBUG_FindNearestSymbol( const DBG_ADDR *addr, int flag,
|
|
struct name_hash ** rtn,
|
|
unsigned int ebp,
|
|
struct list_id * source);
|
|
extern void DEBUG_ReadSymbolTable( const char * filename );
|
|
extern void DEBUG_AddLineNumber( struct name_hash * func, int line_num,
|
|
unsigned long offset );
|
|
extern struct wine_locals *
|
|
DEBUG_AddLocal( struct name_hash * func, int regno,
|
|
int offset,
|
|
int pc_start,
|
|
int pc_end,
|
|
char * name);
|
|
extern int DEBUG_CheckLinenoStatus(const DBG_ADDR *addr);
|
|
extern void DEBUG_GetFuncInfo(struct list_id * ret, const char * file,
|
|
const char * func);
|
|
extern int DEBUG_SetSymbolSize(struct name_hash * sym, unsigned int len);
|
|
extern int DEBUG_SetSymbolBPOff(struct name_hash * sym, unsigned int len);
|
|
extern int DEBUG_GetSymbolAddr(struct name_hash * sym, DBG_ADDR * addr);
|
|
extern int DEBUG_cmp_sym(const void * p1, const void * p2);
|
|
extern BOOL DEBUG_GetLineNumberAddr( struct name_hash *, const int lineno,
|
|
DBG_ADDR *addr, int bp_flag );
|
|
|
|
extern int DEBUG_SetLocalSymbolType(struct wine_locals * sym,
|
|
struct datatype * type);
|
|
extern BOOL DEBUG_Normalize(struct name_hash * nh );
|
|
|
|
/* debugger/info.c */
|
|
extern void DEBUG_PrintBasic( const DBG_VALUE* value, int count, char format );
|
|
extern struct symbol_info DEBUG_PrintAddress( const DBG_ADDR *addr,
|
|
int addrlen, int flag );
|
|
extern void DEBUG_Help(void);
|
|
extern void DEBUG_HelpInfo(void);
|
|
extern struct symbol_info DEBUG_PrintAddressAndArgs( const DBG_ADDR *addr,
|
|
int addrlen,
|
|
unsigned int ebp,
|
|
int flag );
|
|
extern void DEBUG_InfoClass(const char* clsName);
|
|
extern void DEBUG_WalkClasses(void);
|
|
extern void DEBUG_WalkModref(DWORD p);
|
|
extern void DEBUG_DumpModule(DWORD mod);
|
|
extern void DEBUG_WalkModules(void);
|
|
extern void DEBUG_WalkProcess(void);
|
|
extern void DEBUG_WalkThreads(void);
|
|
extern void DEBUG_DumpQueue(DWORD q);
|
|
extern void DEBUG_WalkQueues(void);
|
|
extern void DEBUG_InfoSegments(DWORD s, int v);
|
|
extern void DEBUG_InfoVirtual(void);
|
|
extern void DEBUG_InfoWindow(HWND hWnd);
|
|
extern void DEBUG_WalkWindows(HWND hWnd, int indent);
|
|
|
|
/* debugger/memory.c */
|
|
extern int DEBUG_ReadMemory( const DBG_VALUE* value );
|
|
extern void DEBUG_WriteMemory( const DBG_VALUE* val, int value );
|
|
extern void DEBUG_ExamineMemory( const DBG_VALUE *addr, int count, char format);
|
|
extern void DEBUG_InvalAddr( const DBG_ADDR* addr );
|
|
extern void DEBUG_InvalLinAddr( void* addr );
|
|
#ifdef __i386__
|
|
extern void DEBUG_GetCurrentAddress( DBG_ADDR * );
|
|
extern DWORD DEBUG_ToLinear( const DBG_ADDR *address );
|
|
extern void DEBUG_FixAddress( DBG_ADDR *address, DWORD def );
|
|
extern BOOL DEBUG_FixSegment( DBG_ADDR* addr );
|
|
extern int DEBUG_GetSelectorType( WORD sel );
|
|
extern int DEBUG_IsSelectorSystem( WORD sel );
|
|
#endif
|
|
|
|
/* debugger/module.c */
|
|
extern int DEBUG_LoadEntryPoints( const char * prefix );
|
|
extern void DEBUG_LoadModule32( const char* name, HANDLE hFile, DWORD base );
|
|
extern DBG_MODULE* DEBUG_AddModule(const char* name, int type,
|
|
void* mod_addr, HMODULE hmod);
|
|
extern DBG_MODULE* DEBUG_FindModuleByName(const char* name, int type);
|
|
extern DBG_MODULE* DEBUG_FindModuleByHandle(HANDLE handle, int type);
|
|
extern DBG_MODULE* DEBUG_RegisterPEModule(HMODULE, u_long load_addr, const char* name);
|
|
extern DBG_MODULE* DEBUG_RegisterELFModule(u_long load_addr, const char* name);
|
|
extern void DEBUG_InfoShare(void);
|
|
|
|
/* debugger/msc.c */
|
|
extern int DEBUG_RegisterMSCDebugInfo(DBG_MODULE* module, HANDLE hFile, void* nth, unsigned long nth_ofs);
|
|
extern int DEBUG_RegisterStabsDebugInfo(DBG_MODULE* module, HANDLE hFile, void* nth, unsigned long nth_ofs);
|
|
extern void DEBUG_InitCVDataTypes(void);
|
|
|
|
/* debugger/registers.c */
|
|
extern void DEBUG_InfoRegisters(void);
|
|
extern BOOL DEBUG_ValidateRegisters(void);
|
|
|
|
/* debugger/stack.c */
|
|
extern void DEBUG_InfoStack(void);
|
|
extern void DEBUG_BackTrace(BOOL noisy);
|
|
extern int DEBUG_InfoLocals(void);
|
|
extern int DEBUG_SetFrame(int newframe);
|
|
extern int DEBUG_GetCurrentFrame(struct name_hash ** name,
|
|
unsigned int * eip,
|
|
unsigned int * ebp);
|
|
|
|
/* debugger/stabs.c */
|
|
extern int DEBUG_ReadExecutableDbgInfo(const char* exe_name);
|
|
extern int DEBUG_ProcessElfObject(const char* filename, unsigned int load_offset);
|
|
extern int DEBUG_ParseStabs(char * addr, unsigned int load_offset, unsigned int staboff,
|
|
int stablen, unsigned int strtaboff, int strtablen);
|
|
|
|
/* debugger/types.c */
|
|
extern int DEBUG_nchar;
|
|
extern void DEBUG_InitTypes(void);
|
|
extern struct datatype * DEBUG_NewDataType(enum debug_type xtype,
|
|
const char * typename);
|
|
extern unsigned int DEBUG_TypeDerefPointer(const DBG_VALUE *value, struct datatype ** newtype);
|
|
extern int DEBUG_AddStructElement(struct datatype * dt,
|
|
char * name, struct datatype * type,
|
|
int offset, int size);
|
|
extern int DEBUG_SetStructSize(struct datatype * dt, int size);
|
|
extern int DEBUG_SetPointerType(struct datatype * dt, struct datatype * dt2);
|
|
extern int DEBUG_SetArrayParams(struct datatype * dt, int min, int max,
|
|
struct datatype * dt2);
|
|
extern void DEBUG_Print( const DBG_VALUE *addr, int count, char format, int level );
|
|
extern unsigned int DEBUG_FindStructElement(DBG_VALUE * addr,
|
|
const char * ele_name, int * tmpbuf);
|
|
extern struct datatype * DEBUG_GetPointerType(struct datatype * dt);
|
|
extern int DEBUG_GetObjectSize(struct datatype * dt);
|
|
extern unsigned int DEBUG_ArrayIndex(const DBG_VALUE * addr, DBG_VALUE * result, int index);
|
|
extern struct datatype * DEBUG_FindOrMakePointerType(struct datatype * reftype);
|
|
extern long long int DEBUG_GetExprValue(const DBG_VALUE * addr, char ** format);
|
|
extern int DEBUG_SetBitfieldParams(struct datatype * dt, int offset,
|
|
int nbits, struct datatype * dt2);
|
|
extern int DEBUG_CopyFieldlist(struct datatype * dt, struct datatype * dt2);
|
|
extern enum debug_type DEBUG_GetType(struct datatype * dt);
|
|
extern struct datatype * DEBUG_TypeCast(enum debug_type, const char *);
|
|
extern int DEBUG_PrintTypeCast(const struct datatype *);
|
|
extern int DEBUG_PrintType( const DBG_VALUE* addr );
|
|
|
|
/* debugger/source.c */
|
|
extern void DEBUG_ShowDir(void);
|
|
extern void DEBUG_AddPath(const char * path);
|
|
extern void DEBUG_List(struct list_id * line1, struct list_id * line2,
|
|
int delta);
|
|
extern void DEBUG_NukePath(void);
|
|
extern void DEBUG_Disassemble( const DBG_VALUE *, const DBG_VALUE*, int offset );
|
|
|
|
/* debugger/winedbg.c */
|
|
#define DBG_CHN_MESG 1
|
|
#define DBG_CHN_ERR 2
|
|
#define DBG_CHN_WARN 4
|
|
#define DBG_CHN_FIXME 8
|
|
#define DBG_CHN_TRACE 16
|
|
extern void DEBUG_Output(int chn, const char* buffer, int len);
|
|
extern int DEBUG_Printf(int chn, const char* format, ...);
|
|
extern DBG_INTVAR* DEBUG_GetIntVar(const char*);
|
|
|
|
/* Choose your allocator! */
|
|
#if 1
|
|
/* this one is libc's fast one */
|
|
extern void* DEBUG_XMalloc(size_t size);
|
|
extern void* DEBUG_XReAlloc(void *ptr, size_t size);
|
|
extern char* DEBUG_XStrDup(const char *str);
|
|
|
|
#define DBG_alloc(x) DEBUG_XMalloc(x)
|
|
#define DBG_realloc(x,y) DEBUG_XReAlloc(x,y)
|
|
#define DBG_free(x) free(x)
|
|
#define DBG_strdup(x) DEBUG_XStrDup(x)
|
|
#else
|
|
/* this one is slow (takes 5 minutes to load the debugger on my machine),
|
|
but is pretty crash-proof (can step through malloc() without problems,
|
|
malloc() arena (and other heaps) can be totally wasted and it'll still
|
|
work, etc... if someone could make optimized routines so it wouldn't
|
|
take so long to load, it could be made default) */
|
|
#include "heap.h"
|
|
#define DBG_alloc(x) HeapAlloc(dbg_heap,0,x)
|
|
#define DBG_realloc(x,y) HeapRealloc(dbg_heap,0,x,y)
|
|
#define DBG_free(x) HeapFree(dbg_heap,0,x)
|
|
#define DBG_strdup(x) HEAP_strdupA(dbg_heap,0,x)
|
|
#define DBG_need_heap
|
|
extern HANDLE dbg_heap;
|
|
#endif
|
|
|
|
#define DEBUG_STATUS_OFFSET 0x80003000
|
|
#define DEBUG_STATUS_INTERNAL_ERROR (DEBUG_STATUS_OFFSET+0)
|
|
#define DEBUG_STATUS_NO_SYMBOL (DEBUG_STATUS_OFFSET+1)
|
|
#define DEBUG_STATUS_DIV_BY_ZERO (DEBUG_STATUS_OFFSET+2)
|
|
#define DEBUG_STATUS_BAD_TYPE (DEBUG_STATUS_OFFSET+3)
|
|
|
|
extern DBG_INTVAR DEBUG_IntVars[];
|
|
|
|
#define DBG_IVARNAME(_var) DEBUG_IV_##_var
|
|
#define DBG_IVARSTRUCT(_var) DEBUG_IntVars[DBG_IVARNAME(_var)]
|
|
#define DBG_IVAR(_var) (*(DBG_IVARSTRUCT(_var).pval))
|
|
#define INTERNAL_VAR(_var,_val,_ref,_typ) DBG_IVARNAME(_var),
|
|
enum debug_int_var {
|
|
#include "intvar.h"
|
|
DBG_IV_LAST
|
|
};
|
|
#undef INTERNAL_VAR
|
|
|
|
#endif /* __WINE_DEBUGGER_H */
|