1 /* Wine internal debugger
2 * Interface to Windows debugger API
3 * Copyright 2000-2004 Eric Pouech
5 * This library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Lesser General Public
7 * License as published by the Free Software Foundation; either
8 * version 2.1 of the License, or (at your option) any later version.
10 * This library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Lesser General Public License for more details.
15 * You should have received a copy of the GNU Lesser General Public
16 * License along with this library; if not, write to the Free Software
17 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
21 #include "wine/port.h"
29 #include "wine/exception.h"
30 #include "wine/library.h"
32 #include "wine/debug.h"
37 * + ensure that all commands work as expected in minidump reload function
38 * (and reenable parser usager)
40 * + we always assume the stack grows as on i386 (ie downwards)
42 * + enable back the limited output (depth of structure printing and number of
44 * + make the output as close as possible to what gdb does
45 * - symbol management:
46 * + symbol table loading is broken
47 * + in symbol_get_lvalue, we don't do any scoping (as C does) between local and
48 * global vars (we may need this to force some display for example). A solution
49 * would be always to return arrays with: local vars, global vars, thunks
51 * + some bits of internal types are missing (like type casts and the address
53 * + the type for an enum's value is always inferred as int (winedbg & dbghelp)
54 * + most of the code implies that sizeof(void*) = sizeof(int)
55 * + all computations should be made on long long
56 * o expr computations are in int:s
57 * o bitfield size is on a 4-bytes
58 * + array_index and deref should be the same function (or should share the same
61 * + set a better fix for gdb (proxy mode) than the step-mode hack
62 * + implement function call in debuggee
63 * + trampoline management is broken when getting 16 <=> 32 thunk destination
65 * + thunking of delayed imports doesn't work as expected (ie, when stepping,
66 * it currently stops at first insn with line number during the library
67 * loading). We should identify this (__wine_delay_import) and set a
68 * breakpoint instead of single stepping the library loading.
69 * + it's wrong to copy thread->step_over_bp into process->bp[0] (when
70 * we have a multi-thread debuggee). complete fix must include storing all
71 * thread's step-over bp in process-wide bp array, and not to handle bp
72 * when we have the wrong thread running into that bp
73 * + code in CREATE_PROCESS debug event doesn't work on Windows, as we cannot
74 * get the name of the main module this way. We should rewrite all this code
75 * and store in struct dbg_process as early as possible (before process
76 * creation or attachment), the name of the main module
78 * + define a better way to enable the wine extensions (either DBG SDK function
79 * in dbghelp, or TLS variable, or environment variable or ...)
80 * + audit all files to ensure that we check all potential return values from
81 * every function call to catch the errors
82 * + BTW check also whether the exception mechanism is the best way to return
83 * errors (or find a proper fix for MinGW port)
84 * + use Wine standard list mechanism for all list handling
87 WINE_DEFAULT_DEBUG_CHANNEL(winedbg);
89 struct dbg_process* dbg_curr_process = NULL;
90 struct dbg_thread* dbg_curr_thread = NULL;
94 BOOL dbg_interactiveP = FALSE;
96 static struct dbg_process* dbg_process_list = NULL;
98 struct dbg_internal_var dbg_internal_vars[DBG_IV_LAST];
99 const struct dbg_internal_var* dbg_context_vars;
100 static HANDLE dbg_houtput;
102 static void dbg_outputA(const char* buffer, int len)
104 static char line_buff[4096];
105 static unsigned int line_pos;
111 unsigned int count = min( len, sizeof(line_buff) - line_pos );
112 memcpy( line_buff + line_pos, buffer, count );
116 for (i = line_pos; i > 0; i--) if (line_buff[i-1] == '\n') break;
117 if (!i) /* no newline found */
119 if (len > 0) i = line_pos; /* buffer is full, flush anyway */
122 WriteFile(dbg_houtput, line_buff, i, &w, NULL);
123 memmove( line_buff, line_buff + i, line_pos - i );
128 const char* dbg_W2A(const WCHAR* buffer, unsigned len)
130 static unsigned ansilen;
134 newlen = WideCharToMultiByte(CP_ACP, 0, buffer, len, NULL, 0, NULL, NULL);
135 if (newlen > ansilen)
137 static char* newansi;
139 newansi = HeapReAlloc(GetProcessHeap(), 0, ansi, newlen);
141 newansi = HeapAlloc(GetProcessHeap(), 0, newlen);
142 if (!newansi) return NULL;
146 WideCharToMultiByte(CP_ACP, 0, buffer, len, ansi, newlen, NULL, NULL);
150 void dbg_outputW(const WCHAR* buffer, int len)
152 const char* ansi = dbg_W2A(buffer, len);
153 if (ansi) dbg_outputA(ansi, strlen(ansi));
154 /* FIXME: should CP_ACP be GetConsoleCP()? */
157 int dbg_printf(const char* format, ...)
159 static char buf[4*1024];
163 va_start(valist, format);
164 len = vsnprintf(buf, sizeof(buf), format, valist);
167 if (len <= -1 || len >= sizeof(buf))
169 len = sizeof(buf) - 1;
171 buf[len - 1] = buf[len - 2] = buf[len - 3] = '.';
173 dbg_outputA(buf, len);
177 static unsigned dbg_load_internal_vars(void)
180 DWORD type = REG_DWORD;
182 DWORD count = sizeof(val);
184 struct dbg_internal_var* div = dbg_internal_vars;
186 /* initializes internal vars table */
187 #define INTERNAL_VAR(_var,_val,_ref,_tid) \
188 div->val = _val; div->name = #_var; div->pval = _ref; \
189 div->typeid = _tid; div++;
193 /* @@ Wine registry key: HKCU\Software\Wine\WineDbg */
194 if (RegCreateKeyA(HKEY_CURRENT_USER, "Software\\Wine\\WineDbg", &hkey))
196 WINE_ERR("Cannot create WineDbg key in registry\n");
200 for (i = 0; i < DBG_IV_LAST; i++)
202 if (!dbg_internal_vars[i].pval)
204 if (!RegQueryValueEx(hkey, dbg_internal_vars[i].name, 0,
205 &type, (LPBYTE)&val, &count))
206 dbg_internal_vars[i].val = val;
207 dbg_internal_vars[i].pval = &dbg_internal_vars[i].val;
211 /* set up the debug variables for the CPU context */
212 dbg_context_vars = be_cpu->init_registers(&dbg_context);
216 static unsigned dbg_save_internal_vars(void)
221 /* @@ Wine registry key: HKCU\Software\Wine\WineDbg */
222 if (RegCreateKeyA(HKEY_CURRENT_USER, "Software\\Wine\\WineDbg", &hkey))
224 WINE_ERR("Cannot create WineDbg key in registry\n");
228 for (i = 0; i < DBG_IV_LAST; i++)
230 /* FIXME: type should be inferred from basic type -if any- of intvar */
231 if (dbg_internal_vars[i].pval == &dbg_internal_vars[i].val)
232 RegSetValueEx(hkey, dbg_internal_vars[i].name, 0,
233 REG_DWORD, (const void*)dbg_internal_vars[i].pval,
234 sizeof(*dbg_internal_vars[i].pval));
240 const struct dbg_internal_var* dbg_get_internal_var(const char* name)
242 const struct dbg_internal_var* div;
244 for (div = &dbg_internal_vars[DBG_IV_LAST - 1]; div >= dbg_internal_vars; div--)
246 if (!strcmp(div->name, name)) return div;
248 for (div = dbg_context_vars; div->name; div++)
250 if (!strcasecmp(div->name, name)) return div;
256 unsigned dbg_num_processes(void)
258 struct dbg_process* p;
261 for (p = dbg_process_list; p; p = p->next)
266 struct dbg_process* dbg_get_process(DWORD pid)
268 struct dbg_process* p;
270 for (p = dbg_process_list; p; p = p->next)
271 if (p->pid == pid) break;
275 struct dbg_process* dbg_get_process_h(HANDLE h)
277 struct dbg_process* p;
279 for (p = dbg_process_list; p; p = p->next)
280 if (p->handle == h) break;
284 struct dbg_process* dbg_add_process(const struct be_process_io* pio, DWORD pid, HANDLE h)
286 struct dbg_process* p;
288 if ((p = dbg_get_process(pid)))
292 WINE_ERR("Process (%04x) is already defined\n", pid);
303 if (!(p = HeapAlloc(GetProcessHeap(), 0, sizeof(struct dbg_process)))) return NULL;
310 p->continue_on_first_exception = FALSE;
311 p->active_debuggee = FALSE;
312 p->next_bp = 1; /* breakpoint 0 is reserved for step-over */
313 memset(p->bp, 0, sizeof(p->bp));
314 p->delayed_bp = NULL;
315 p->num_delayed_bp = 0;
316 p->source_ofiles = NULL;
317 p->search_path = NULL;
318 p->source_current_file[0] = '\0';
319 p->source_start_line = -1;
320 p->source_end_line = -1;
322 p->next = dbg_process_list;
324 if (dbg_process_list) dbg_process_list->prev = p;
325 dbg_process_list = p;
329 void dbg_set_process_name(struct dbg_process* p, const WCHAR* imageName)
331 assert(p->imageName == NULL);
334 WCHAR* tmp = HeapAlloc(GetProcessHeap(), 0, (lstrlenW(imageName) + 1) * sizeof(WCHAR));
335 if (tmp) p->imageName = lstrcpyW(tmp, imageName);
339 void dbg_del_process(struct dbg_process* p)
343 while (p->threads) dbg_del_thread(p->threads);
345 for (i = 0; i < p->num_delayed_bp; i++)
346 if (p->delayed_bp[i].is_symbol)
347 HeapFree(GetProcessHeap(), 0, p->delayed_bp[i].u.symbol.name);
349 HeapFree(GetProcessHeap(), 0, p->delayed_bp);
351 source_free_files(p);
352 if (p->prev) p->prev->next = p->next;
353 if (p->next) p->next->prev = p->prev;
354 if (p == dbg_process_list) dbg_process_list = p->next;
355 if (p == dbg_curr_process) dbg_curr_process = NULL;
356 HeapFree(GetProcessHeap(), 0, (char*)p->imageName);
357 HeapFree(GetProcessHeap(), 0, p);
360 /******************************************************************
363 * Initializes the dbghelp library, and also sets the application directory
364 * as a place holder for symbol searches.
366 BOOL dbg_init(HANDLE hProc, const WCHAR* in, BOOL invade)
370 ret = SymInitialize(hProc, NULL, invade);
375 for (last = in + lstrlenW(in) - 1; last >= in; last--)
377 if (*last == '/' || *last == '\\')
380 tmp = HeapAlloc(GetProcessHeap(), 0, (1024 + 1 + (last - in) + 1) * sizeof(WCHAR));
381 if (tmp && SymGetSearchPathW(hProc, tmp, 1024))
383 WCHAR* x = tmp + lstrlenW(tmp);
386 memcpy(x, in, (last - in) * sizeof(WCHAR));
388 ret = SymSetSearchPathW(hProc, tmp);
391 HeapFree(GetProcessHeap(), 0, tmp);
399 struct mod_loader_info
402 IMAGEHLP_MODULE* imh_mod;
405 static BOOL CALLBACK mod_loader_cb(PCSTR mod_name, ULONG base, PVOID ctx)
407 struct mod_loader_info* mli = (struct mod_loader_info*)ctx;
409 if (!strcmp(mod_name, "<wine-loader>"))
411 if (SymGetModuleInfo(mli->handle, base, mli->imh_mod))
412 return FALSE; /* stop enum */
417 BOOL dbg_get_debuggee_info(HANDLE hProcess, IMAGEHLP_MODULE* imh_mod)
419 struct mod_loader_info mli;
422 /* this will resynchronize builtin dbghelp's internal ELF module list */
423 SymLoadModule(hProcess, 0, 0, 0, 0, 0);
424 mli.handle = hProcess;
425 mli.imh_mod = imh_mod;
426 imh_mod->SizeOfStruct = sizeof(*imh_mod);
427 imh_mod->BaseOfImage = 0;
428 /* this is a wine specific options to return also ELF modules in the
431 SymSetOptions((opt = SymGetOptions()) | 0x40000000);
432 SymEnumerateModules(hProcess, mod_loader_cb, (void*)&mli);
435 return imh_mod->BaseOfImage != 0;
438 BOOL dbg_load_module(HANDLE hProc, HANDLE hFile, const WCHAR* name, DWORD base, DWORD size)
440 BOOL ret = SymLoadModuleExW(hProc, NULL, name, NULL, base, size, NULL, 0);
443 IMAGEHLP_MODULEW64 ihm;
444 ihm.SizeOfStruct = sizeof(ihm);
445 if (SymGetModuleInfoW64(hProc, base, &ihm) && (ihm.PdbUnmatched || ihm.DbgUnmatched))
446 dbg_printf("Loaded unmatched debug information for %s\n", wine_dbgstr_w(name));
451 struct dbg_thread* dbg_get_thread(struct dbg_process* p, DWORD tid)
453 struct dbg_thread* t;
456 for (t = p->threads; t; t = t->next)
457 if (t->tid == tid) break;
461 struct dbg_thread* dbg_add_thread(struct dbg_process* p, DWORD tid,
464 struct dbg_thread* t = HeapAlloc(GetProcessHeap(), 0, sizeof(struct dbg_thread));
473 t->exec_mode = dbg_exec_cont;
475 t->step_over_bp.enabled = FALSE;
476 t->step_over_bp.refcount = 0;
477 t->stopped_xpoint = -1;
478 t->in_exception = FALSE;
482 t->addr_mode = AddrModeFlat;
484 snprintf(t->name, sizeof(t->name), "%04x", tid);
486 t->next = p->threads;
488 if (p->threads) p->threads->prev = t;
494 void dbg_del_thread(struct dbg_thread* t)
496 HeapFree(GetProcessHeap(), 0, t->frames);
497 if (t->prev) t->prev->next = t->next;
498 if (t->next) t->next->prev = t->prev;
499 if (t == t->process->threads) t->process->threads = t->next;
500 if (t == dbg_curr_thread) dbg_curr_thread = NULL;
501 HeapFree(GetProcessHeap(), 0, t);
504 void dbg_set_option(const char* option, const char* val)
506 if (!strcasecmp(option, "module_load_mismatched"))
508 DWORD opt = SymGetOptions();
510 dbg_printf("Option: module_load_mismatched %s\n", opt & SYMOPT_LOAD_ANYTHING ? "true" : "false");
511 else if (!strcasecmp(val, "true")) opt |= SYMOPT_LOAD_ANYTHING;
512 else if (!strcasecmp(val, "false")) opt &= ~SYMOPT_LOAD_ANYTHING;
515 dbg_printf("Syntax: module_load_mismatched [true|false]\n");
520 else if (!strcasecmp(option, "symbol_picker"))
523 dbg_printf("Option: symbol_picker %s\n",
524 symbol_current_picker == symbol_picker_interactive ? "interactive" : "scoped");
525 else if (!strcasecmp(val, "interactive"))
526 symbol_current_picker = symbol_picker_interactive;
527 else if (!strcasecmp(val, "scoped"))
528 symbol_current_picker = symbol_picker_scoped;
531 dbg_printf("Syntax: symbol_picker [interactive|scoped]\n");
535 else dbg_printf("Unknown option '%s'\n", option);
538 BOOL dbg_interrupt_debuggee(void)
540 if (!dbg_process_list) return FALSE;
541 /* FIXME: since we likely have a single process, signal the first process
544 if (dbg_process_list->next) dbg_printf("Ctrl-C: only stopping the first process\n");
545 else dbg_printf("Ctrl-C: stopping debuggee\n");
546 dbg_process_list->continue_on_first_exception = FALSE;
547 return DebugBreakProcess(dbg_process_list->handle);
550 static BOOL WINAPI ctrl_c_handler(DWORD dwCtrlType)
552 if (dwCtrlType == CTRL_C_EVENT)
554 return dbg_interrupt_debuggee();
559 static void dbg_init_console(void)
561 /* set our control-C handler */
562 SetConsoleCtrlHandler(ctrl_c_handler, TRUE);
564 /* set our own title */
565 SetConsoleTitle("Wine Debugger");
568 static int dbg_winedbg_usage(BOOL advanced)
572 dbg_printf("Usage:\n"
573 " winedbg cmdline launch process 'cmdline' (as if you were starting\n"
574 " it with wine) and run WineDbg on it\n"
575 " winedbg <num> attach to running process of pid <num> and run\n"
577 " winedbg --gdb cmdline launch process 'cmdline' (as if you were starting\n"
578 " wine) and run gdb (proxied) on it\n"
579 " winedbg --gdb <num> attach to running process of pid <num> and run\n"
580 " gdb (proxied) on it\n"
581 " winedbg file.mdmp reload the minidump file.mdmp into memory and run\n"
583 " winedbg --help prints advanced options\n");
586 dbg_printf("Usage:\n\twinedbg [ [ --gdb ] [ prog-name [ prog-args ] | <num> | file.mdmp | --help ]\n");
590 struct backend_cpu* be_cpu;
592 extern struct backend_cpu be_i386;
594 extern struct backend_cpu be_ppc;
596 extern struct backend_cpu be_alpha;
598 extern struct backend_cpu be_x86_64;
603 int main(int argc, char** argv)
606 HANDLE hFile = INVALID_HANDLE_VALUE;
620 /* Initialize the output */
621 dbg_houtput = GetStdHandle(STD_OUTPUT_HANDLE);
623 /* Initialize internal vars */
624 if (!dbg_load_internal_vars()) return -1;
626 /* as we don't care about exec name */
629 if (argc && !strcmp(argv[0], "--help"))
630 return dbg_winedbg_usage(TRUE);
632 if (argc && !strcmp(argv[0], "--gdb"))
634 retv = gdb_main(argc, argv);
635 if (retv == -1) dbg_winedbg_usage(FALSE);
640 SymSetOptions((SymGetOptions() & ~(SYMOPT_UNDNAME)) |
641 SYMOPT_LOAD_LINES | SYMOPT_DEFERRED_LOADS | SYMOPT_AUTO_PUBLICS);
643 if (argc && (!strcmp(argv[0], "--auto") || !strcmp(argv[0], "--minidump")))
645 /* force some internal variables */
646 DBG_IVAR(BreakOnDllLoad) = 0;
647 dbg_houtput = GetStdHandle(STD_ERROR_HANDLE);
648 switch (dbg_active_auto(argc, argv))
650 case start_ok: return 0;
651 case start_error_parse: return dbg_winedbg_usage(FALSE);
652 case start_error_init: return -1;
656 while (argc > 0 && argv[0][0] == '-')
658 if (!strcmp(argv[0], "--command"))
661 hFile = parser_generate_command_file(argv[0], NULL);
662 if (hFile == INVALID_HANDLE_VALUE)
664 dbg_printf("Couldn't open temp file (%u)\n", GetLastError());
670 if (!strcmp(argv[0], "--file"))
673 hFile = CreateFileA(argv[0], GENERIC_READ|DELETE, 0,
674 NULL, OPEN_EXISTING, FILE_ATTRIBUTE_NORMAL, 0);
675 if (hFile == INVALID_HANDLE_VALUE)
677 dbg_printf("Couldn't open file %s (%u)\n", argv[0], GetLastError());
683 if (!strcmp(argv[0], "--"))
688 return dbg_winedbg_usage(FALSE);
690 if (!argc) ds = start_ok;
691 else if ((ds = dbg_active_attach(argc, argv)) == start_error_parse &&
692 (ds = minidump_reload(argc, argv)) == start_error_parse)
693 ds = dbg_active_launch(argc, argv);
696 case start_ok: break;
697 case start_error_parse: return dbg_winedbg_usage(FALSE);
698 case start_error_init: return -1;
701 if (dbg_curr_process)
703 dbg_printf("WineDbg starting on pid %04x\n", dbg_curr_pid);
704 if (dbg_curr_process->active_debuggee) dbg_active_wait_for_first_exception();
707 dbg_interactiveP = TRUE;
708 parser_handle(hFile);
710 while (dbg_process_list)
711 dbg_process_list->process_io->close_process(dbg_process_list, FALSE);
713 dbg_save_internal_vars();