4 * Copyright 1995 Alexandre Julliard
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
21 #ifndef __WINE_DEBUGGER_H
22 #define __WINE_DEBUGGER_H
27 #define NONAMELESSUNION
28 #define NONAMELESSSTRUCT
30 #define WIN32_NO_STATUS
31 #define WIN32_LEAN_AND_MEAN
41 /* the debugger uses these exceptions for it's internal use */
42 #define DEBUG_STATUS_OFFSET 0x80003000
43 #define DEBUG_STATUS_INTERNAL_ERROR (DEBUG_STATUS_OFFSET+0) /* something went wrong */
44 #define DEBUG_STATUS_NO_SYMBOL (DEBUG_STATUS_OFFSET+1) /* no symbol found in lookup */
45 #define DEBUG_STATUS_DIV_BY_ZERO (DEBUG_STATUS_OFFSET+2)
46 #define DEBUG_STATUS_BAD_TYPE (DEBUG_STATUS_OFFSET+3) /* no type found, when type was expected */
47 #define DEBUG_STATUS_NO_FIELD (DEBUG_STATUS_OFFSET+4) /* when dereferencing a struct, the field was not found */
48 #define DEBUG_STATUS_ABORT (DEBUG_STATUS_OFFSET+5) /* user aborted on going action */
49 #define DEBUG_STATUS_CANT_DEREF (DEBUG_STATUS_OFFSET+6) /* either not deref:able, or index out of bounds */
50 #define DEBUG_STATUS_NOT_AN_INTEGER (DEBUG_STATUS_OFFSET+7) /* requiring an integral value */
53 * Return values for symbol_get_function_line_status. Used to determine
54 * what to do when the 'step' command is given.
59 dbg_not_on_a_line_number,
64 enum dbg_internal_types
66 dbg_itype_first = 0xffffff00,
67 dbg_itype_unsigned_int,
69 dbg_itype_signed_char_int,
70 dbg_itype_unsigned_char_int,
71 dbg_itype_unsigned_short_int,
72 dbg_itype_signed_short_int,
73 dbg_itype_unsigned_long_int,
74 dbg_itype_signed_long_int,
75 dbg_itype_unsigned_longlong_int,
76 dbg_itype_signed_longlong_int,
79 dbg_itype_short_real, /* aka float */
80 dbg_itype_real, /* aka double */
81 dbg_itype_long_real, /* aka long double */
84 dbg_itype_segptr, /* hack for segmented pointers */
85 dbg_itype_none = 0xffffffff
88 /* type description (in the following order):
89 * - if 'id' is dbg_itype_none (whatever 'module' value), the type isn't known
90 * - if 'module' is 0, it's an internal type (id is one of dbg_itype...)
91 * - if 'module' is non 0, then 'id' is a type ID referring to module (loaded in
92 * dbghelp) which (linear) contains address 'module'.
100 struct dbg_lvalue /* structure to hold left-values... */
102 int cookie; /* DLV_??? */
103 /* DLV_TARGET references an address in debuggee's address space, whereas DLV_HOST
104 * references the winedbg's address space
106 # define DLV_TARGET 0xF00D
107 # define DLV_HOST 0x50DA
109 struct dbg_type type;
114 dbg_exec_cont, /* Continue execution */
115 dbg_exec_step_over_line, /* Stepping over a call to next source line */
116 dbg_exec_step_into_line, /* Step to next source line, stepping in if needed */
117 dbg_exec_step_over_insn, /* Stepping over a call */
118 dbg_exec_step_into_insn, /* Single-stepping an instruction */
119 dbg_exec_finish, /* Single-step until we exit current frame */
121 EXEC_STEP_OVER_TRAMPOLINE, /* Step over trampoline. Requires that we dig the real
122 * return value off the stack and set breakpoint there -
123 * not at the instr just after the call.
128 struct dbg_breakpoint
131 unsigned long enabled : 1,
136 struct /* only used for watchpoints */
141 struct expr* condition;
144 /* Wine extension; Windows doesn't have a name for this code. This is an
145 undocumented exception understood by MS VC debugger, allowing the program
146 to name a particular thread. Search google.com or deja.com for "0x406d1388"
148 #define EXCEPTION_NAME_THREAD 0x406D1388
150 /* Helper structure */
151 typedef struct tagTHREADNAME_INFO
153 DWORD dwType; /* Must be 0x1000 */
154 LPCTSTR szName; /* Pointer to name - limited to 9 bytes (8 characters + terminator) */
155 DWORD dwThreadID; /* Thread ID (-1 = caller thread) */
156 DWORD dwFlags; /* Reserved for future use. Must be zero. */
161 struct dbg_process* process;
165 enum dbg_exec_mode exec_mode; /* mode the thread is run (step/run...) */
166 int exec_count; /* count of mode operations */
167 ADDRESS_MODE addr_mode; /* mode */
168 int stopped_xpoint; /* xpoint on which the thread has stopped (-1 if none) */
169 struct dbg_breakpoint step_over_bp;
171 struct dbg_thread* next;
172 struct dbg_thread* prev;
173 BOOL in_exception; /* TRUE if thread stopped with an exception */
174 EXCEPTION_RECORD excpt_record; /* only valid when in_exception is TRUE */
184 struct dbg_delayed_bp
199 #define MAX_BREAKPOINTS 100
204 const struct be_process_io* process_io;
205 const char* imageName;
206 struct dbg_thread* threads;
207 unsigned continue_on_first_exception;
208 struct dbg_breakpoint bp[MAX_BREAKPOINTS];
210 struct dbg_delayed_bp* delayed_bp;
212 struct dbg_process* next;
213 struct dbg_process* prev;
216 /* describes the way the debugger interacts with a given process */
219 BOOL (WINAPI *read)(HANDLE, const void*, void*, DWORD, DWORD*);
220 BOOL (WINAPI *write)(HANDLE, void*, const void*, DWORD, DWORD*);
223 extern struct dbg_process* dbg_curr_process;
224 extern DWORD dbg_curr_pid;
225 extern struct dbg_thread* dbg_curr_thread;
226 extern DWORD dbg_curr_tid;
227 extern CONTEXT dbg_context;
228 extern BOOL dbg_interactiveP;
230 struct dbg_internal_var
235 unsigned long typeid; /* always internal type */
238 enum sym_get_lval {sglv_found, sglv_unknown, sglv_aborted};
244 type_expr_udt_struct,
246 type_expr_enumeration
251 enum type_expr_e type;
252 unsigned deref_count;
255 struct dbg_type type;
260 enum dbg_start {start_ok, start_error_parse, start_error_init};
263 extern void break_set_xpoints(BOOL set);
264 extern BOOL break_add_break(const ADDRESS* addr, BOOL verbose, BOOL swbp);
265 extern BOOL break_add_break_from_lvalue(const struct dbg_lvalue* value, BOOL swbp);
266 extern void break_add_break_from_id(const char* name, int lineno, BOOL swbp);
267 extern void break_add_break_from_lineno(int lineno, BOOL swbp);
268 extern void break_add_watch_from_lvalue(const struct dbg_lvalue* lvalue);
269 extern void break_add_watch_from_id(const char* name);
270 extern void break_check_delayed_bp(void);
271 extern void break_delete_xpoint(int num);
272 extern void break_delete_xpoints_from_module(unsigned long base);
273 extern void break_enable_xpoint(int num, BOOL enable);
274 extern void break_info(void);
275 extern BOOL break_should_continue(ADDRESS* addr, DWORD code, int* count, BOOL* is_break);
276 extern void break_suspend_execution(void);
277 extern void break_restart_execution(int count);
278 extern int break_add_condition(int bpnum, struct expr* exp);
281 extern void parser(const char*);
282 extern void parser_handle(HANDLE);
283 extern int input_read_line(const char* pfx, char* buffer, int size);
284 extern int input_fetch_entire_line(const char* pfx, char** line);
287 extern void lexeme_flush(void);
288 extern char* lexeme_alloc(const char*);
289 extern char* lexeme_alloc_size(int);
292 extern int display_print(void);
293 extern int display_add(struct expr* exp, int count, char format);
294 extern int display_delete(int displaynum);
295 extern int display_info(void);
296 extern int display_enable(int displaynum, int enable);
299 extern void expr_free_all(void);
300 extern struct expr* expr_alloc_internal_var(const char* name);
301 extern struct expr* expr_alloc_symbol(const char* name);
302 extern struct expr* expr_alloc_sconstant(int val);
303 extern struct expr* expr_alloc_uconstant(unsigned val);
304 extern struct expr* expr_alloc_string(const char* str);
305 extern struct expr* expr_alloc_binary_op(int oper, struct expr*, struct expr*);
306 extern struct expr* expr_alloc_unary_op(int oper, struct expr*);
307 extern struct expr* expr_alloc_pstruct(struct expr*, const char* element);
308 extern struct expr* expr_alloc_struct(struct expr*, const char* element);
309 extern struct expr* expr_alloc_func_call(const char*, int nargs, ...);
310 extern struct expr* expr_alloc_typecast(struct type_expr_t*, struct expr*);
311 extern struct dbg_lvalue expr_eval(struct expr*);
312 extern struct expr* expr_clone(const struct expr* exp, BOOL *local_binding);
313 extern int expr_free(struct expr* exp);
314 extern int expr_print(const struct expr* exp);
317 extern void print_help(void);
318 extern void info_help(void);
319 extern void info_win32_module(DWORD mod);
320 extern void info_win32_class(HWND hWnd, const char* clsName);
321 extern void info_win32_window(HWND hWnd, BOOL detailed);
322 extern void info_win32_processes(void);
323 extern void info_win32_threads(void);
324 extern void info_win32_exceptions(DWORD tid);
325 extern void info_win32_virtual(DWORD pid);
326 extern void info_win32_segments(DWORD start, int length);
327 extern void info_wine_dbg_channel(BOOL add, const char* chnl, const char* name);
330 extern BOOL memory_read_value(const struct dbg_lvalue* lvalue, DWORD size, void* result);
331 extern BOOL memory_write_value(const struct dbg_lvalue* val, DWORD size, void* value);
332 extern void memory_examine(const struct dbg_lvalue *lvalue, int count, char format);
333 extern void* memory_to_linear_addr(const ADDRESS* address);
334 extern BOOL memory_get_current_pc(ADDRESS* address);
335 extern BOOL memory_get_current_stack(ADDRESS* address);
336 extern BOOL memory_get_current_frame(ADDRESS* address);
337 extern BOOL memory_get_string(struct dbg_process* pcs, void* addr, BOOL in_debuggee, BOOL unicode, char* buffer, int size);
338 extern BOOL memory_get_string_indirect(struct dbg_process* pcs, void* addr, BOOL unicode, char* buffer, int size);
339 extern BOOL memory_get_register(DWORD regno, DWORD** value, char* buffer, int len);
340 extern void memory_disassemble(const struct dbg_lvalue*, const struct dbg_lvalue*, int instruction_count);
341 extern BOOL memory_disasm_one_insn(ADDRESS* addr);
342 extern void print_bare_address(const ADDRESS* addr);
343 extern void print_address(const ADDRESS* addr, BOOLEAN with_line);
344 extern void print_basic(const struct dbg_lvalue* value, int count, char format);
347 extern void source_list(IMAGEHLP_LINE* src1, IMAGEHLP_LINE* src2, int delta);
348 extern void source_list_from_addr(const ADDRESS* addr, int nlines);
349 extern void source_show_path(void);
350 extern void source_add_path(const char* path);
351 extern void source_nuke_path(void);
354 extern void stack_info(void);
355 extern void stack_backtrace(DWORD threadID);
356 extern BOOL stack_set_frame(int newframe);
357 extern BOOL stack_get_current_frame(IMAGEHLP_STACK_FRAME* ihsf);
358 extern unsigned stack_fetch_frames(void);
359 extern BOOL stack_get_current_symbol(SYMBOL_INFO* sym);
362 extern enum sym_get_lval symbol_get_lvalue(const char* name, const int lineno, struct dbg_lvalue* addr, BOOL bp_disp);
363 extern void symbol_read_symtable(const char* filename, unsigned long offset);
364 extern enum dbg_line_status symbol_get_function_line_status(const ADDRESS* addr);
365 extern BOOL symbol_get_line(const char* filename, const char* func, IMAGEHLP_LINE* ret);
366 extern void symbol_info(const char* str);
367 extern int symbol_info_locals(void);
368 extern BOOL symbol_is_local(const char* name);
371 extern void dbg_run_debuggee(const char* args);
372 extern void dbg_wait_next_exception(DWORD cont, int count, int mode);
373 extern enum dbg_start dbg_active_attach(int argc, char* argv[]);
374 extern enum dbg_start dbg_active_launch(int argc, char* argv[]);
375 /* temporary for tgt_active.c */
376 extern enum dbg_action_mode {none_mode = 0, winedbg_mode, automatic_mode, gdb_mode} dbg_action_mode;
377 extern unsigned dbg_main_loop(HANDLE);
380 extern void minidump_write(const char*, const EXCEPTION_RECORD*);
383 extern void print_value(const struct dbg_lvalue* addr, char format, int level);
384 extern int types_print_type(const struct dbg_type*, BOOL details);
385 extern int print_types(void);
386 extern long int types_extract_as_integer(const struct dbg_lvalue*);
387 extern void types_extract_as_address(const struct dbg_lvalue*, ADDRESS*);
388 extern BOOL types_deref(const struct dbg_lvalue* value, struct dbg_lvalue* result);
389 extern BOOL types_udt_find_element(struct dbg_lvalue* value, const char* name, long int* tmpbuf);
390 extern BOOL types_array_index(const struct dbg_lvalue* value, int index, struct dbg_lvalue* result);
391 extern BOOL types_get_info(const struct dbg_type*, IMAGEHLP_SYMBOL_TYPE_INFO, void*);
392 extern struct dbg_type types_find_pointer(const struct dbg_type* type);
393 extern struct dbg_type types_find_type(unsigned long linear, const char* name, enum SymTagEnum tag);
396 extern void dbg_outputA(const char* buffer, int len);
397 extern void dbg_outputW(const WCHAR* buffer, int len);
399 extern int dbg_printf(const char* format, ...) __attribute__((format (printf,1,2)));
401 extern int dbg_printf(const char* format, ...);
403 extern const struct dbg_internal_var* dbg_get_internal_var(const char*);
404 extern BOOL dbg_attach_debuggee(DWORD pid, BOOL cofe, BOOL wfe);
405 extern BOOL dbg_detach_debuggee(void);
406 extern BOOL dbg_interrupt_debuggee(void);
407 extern struct dbg_process* dbg_add_process(DWORD pid, HANDLE h);
408 extern void dbg_set_process_name(struct dbg_process* p, const char* name);
409 extern struct dbg_process* dbg_get_process(DWORD pid);
410 extern void dbg_del_process(struct dbg_process* p);
411 struct dbg_thread* dbg_add_thread(struct dbg_process* p, DWORD tid, HANDLE h, void* teb);
412 extern struct dbg_thread* dbg_get_thread(struct dbg_process* p, DWORD tid);
413 extern void dbg_del_thread(struct dbg_thread* t);
414 extern BOOL dbg_get_debuggee_info(HANDLE hProcess, IMAGEHLP_MODULE* imh_mod);
417 extern BOOL gdb_remote(unsigned int);
419 static inline BOOL dbg_read_memory(const void* addr, void* buffer, size_t len)
422 return dbg_curr_process->process_io->read(dbg_curr_process->handle, addr, buffer, len, &rlen) && len == rlen;
425 static inline BOOL dbg_write_memory(void* addr, const void* buffer, size_t len)
428 return dbg_curr_process->process_io->write(dbg_curr_process->handle, addr, buffer, len, &wlen) && len == wlen;
431 static inline void* dbg_heap_realloc(void* buffer, size_t size)
433 return (buffer) ? HeapReAlloc(GetProcessHeap(), 0, buffer, size) :
434 HeapAlloc(GetProcessHeap(), 0, size);
437 extern struct dbg_internal_var dbg_internal_vars[];
438 extern const struct dbg_internal_var* dbg_context_vars;
440 #define DBG_IVARNAME(_var) dbg_internal_var_##_var
441 #define DBG_IVARSTRUCT(_var) dbg_internal_vars[DBG_IVARNAME(_var)]
442 #define DBG_IVAR(_var) (*(DBG_IVARSTRUCT(_var).pval))
443 #define INTERNAL_VAR(_var,_val,_ref,itype) DBG_IVARNAME(_var),
451 /* include CPU dependent bits */
454 #endif /* __WINE_DEBUGGER_H */