Release 1.2-rc6.
[wine/gsoc-2012-control.git] / programs / winedbg / memory.c
blob7d6112a56a7d11034e9ad3989f6b3c5b932abf16
1 /*
2 * Debugger memory handling
4 * Copyright 1993 Eric Youngdale
5 * Copyright 1995 Alexandre Julliard
6 * Copyright 2000-2005 Eric Pouech
8 * This library is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public
10 * License as published by the Free Software Foundation; either
11 * version 2.1 of the License, or (at your option) any later version.
13 * This library is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with this library; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
23 #include "config.h"
24 #include "wine/port.h"
26 #include <stdlib.h>
27 #include <string.h>
28 #include <stdio.h>
30 #include "debugger.h"
31 #include "wine/debug.h"
33 WINE_DEFAULT_DEBUG_CHANNEL(winedbg);
35 void* be_cpu_linearize(HANDLE hThread, const ADDRESS64* addr)
37 assert(addr->Mode == AddrModeFlat);
38 return (void*)(DWORD_PTR)addr->Offset;
41 unsigned be_cpu_build_addr(HANDLE hThread, const CONTEXT* ctx, ADDRESS64* addr,
42 unsigned seg, unsigned long offset)
44 addr->Mode = AddrModeFlat;
45 addr->Segment = 0; /* don't need segment */
46 addr->Offset = offset;
47 return TRUE;
50 void* memory_to_linear_addr(const ADDRESS64* addr)
52 return be_cpu->linearize(dbg_curr_thread->handle, addr);
55 BOOL memory_get_current_pc(ADDRESS64* addr)
57 assert(be_cpu->get_addr);
58 return be_cpu->get_addr(dbg_curr_thread->handle, &dbg_context,
59 be_cpu_addr_pc, addr);
62 BOOL memory_get_current_stack(ADDRESS64* addr)
64 assert(be_cpu->get_addr);
65 return be_cpu->get_addr(dbg_curr_thread->handle, &dbg_context,
66 be_cpu_addr_stack, addr);
69 BOOL memory_get_current_frame(ADDRESS64* addr)
71 assert(be_cpu->get_addr);
72 return be_cpu->get_addr(dbg_curr_thread->handle, &dbg_context,
73 be_cpu_addr_frame, addr);
76 static void memory_report_invalid_addr(const void* addr)
78 ADDRESS64 address;
80 address.Mode = AddrModeFlat;
81 address.Segment = 0;
82 address.Offset = (unsigned long)addr;
83 dbg_printf("*** Invalid address ");
84 print_address(&address, FALSE);
85 dbg_printf(" ***\n");
88 /***********************************************************************
89 * memory_read_value
91 * Read a memory value.
93 BOOL memory_read_value(const struct dbg_lvalue* lvalue, DWORD size, void* result)
95 BOOL ret = FALSE;
97 if (lvalue->cookie == DLV_TARGET)
99 void* linear = memory_to_linear_addr(&lvalue->addr);
100 if (!(ret = dbg_read_memory(linear, result, size)))
101 memory_report_invalid_addr(linear);
103 else
105 if (lvalue->addr.Offset)
107 memcpy(result, (void*)(DWORD_PTR)lvalue->addr.Offset, size);
108 ret = TRUE;
111 return ret;
114 /***********************************************************************
115 * memory_write_value
117 * Store a value in memory.
119 BOOL memory_write_value(const struct dbg_lvalue* lvalue, DWORD size, void* value)
121 BOOL ret = TRUE;
122 DWORD64 os;
124 if (!types_get_info(&lvalue->type, TI_GET_LENGTH, &os)) return FALSE;
125 if (size != os)
127 dbg_printf("Size mismatch in memory_write_value, got %u from type while expecting %u\n",
128 (DWORD)os, size);
129 return FALSE;
132 /* FIXME: only works on little endian systems */
133 if (lvalue->cookie == DLV_TARGET)
135 void* linear = memory_to_linear_addr(&lvalue->addr);
136 if (!(ret = dbg_write_memory(linear, value, size)))
137 memory_report_invalid_addr(linear);
139 else
141 memcpy((void*)(DWORD_PTR)lvalue->addr.Offset, value, size);
143 return ret;
146 /***********************************************************************
147 * memory_examine
149 * Implementation of the 'x' command.
151 void memory_examine(const struct dbg_lvalue *lvalue, int count, char format)
153 int i;
154 char buffer[256];
155 ADDRESS64 addr;
156 void *linear;
158 types_extract_as_address(lvalue, &addr);
159 linear = memory_to_linear_addr(&addr);
161 if (format != 'i' && count > 1)
163 print_address(&addr, FALSE);
164 dbg_printf(": ");
167 switch (format)
169 case 'u':
170 if (count == 1) count = 256;
171 memory_get_string(dbg_curr_process, linear,
172 TRUE, TRUE, buffer, min(count, sizeof(buffer)));
173 dbg_printf("%s\n", buffer);
174 return;
175 case 's':
176 if (count == 1) count = 256;
177 memory_get_string(dbg_curr_process, linear,
178 TRUE, FALSE, buffer, min(count, sizeof(buffer)));
179 dbg_printf("%s\n", buffer);
180 return;
181 case 'i':
182 while (count-- && memory_disasm_one_insn(&addr));
183 return;
184 case 'g':
185 while (count--)
187 GUID guid;
188 if (!dbg_read_memory(linear, &guid, sizeof(guid)))
190 memory_report_invalid_addr(linear);
191 break;
193 dbg_printf("{%08x-%04x-%04x-%02x%02x-%02x%02x%02x%02x%02x%02x}\n",
194 guid.Data1, guid.Data2, guid.Data3,
195 guid.Data4[0], guid.Data4[1], guid.Data4[2], guid.Data4[3],
196 guid.Data4[4], guid.Data4[5], guid.Data4[6], guid.Data4[7]);
197 linear = (char*)linear + sizeof(guid);
198 addr.Offset += sizeof(guid);
199 if (count)
201 print_address(&addr, FALSE);
202 dbg_printf(": ");
205 return;
207 #define DO_DUMP2(_t,_l,_f,_vv) { \
208 _t _v; \
209 for (i = 0; i < count; i++) { \
210 if (!dbg_read_memory(linear, &_v, sizeof(_t))) \
211 { memory_report_invalid_addr(linear); break; } \
212 dbg_printf(_f, (_vv)); \
213 addr.Offset += sizeof(_t); \
214 linear = (char*)linear + sizeof(_t); \
215 if ((i % (_l)) == (_l) - 1 && i != count - 1) \
217 dbg_printf("\n"); \
218 print_address(&addr, FALSE); \
219 dbg_printf(": "); \
222 dbg_printf("\n"); \
224 #define DO_DUMP(_t,_l,_f) DO_DUMP2(_t,_l,_f,_v)
226 case 'x': DO_DUMP(int, 4, " %8.8x"); break;
227 case 'd': DO_DUMP(unsigned int, 4, " %4.4d"); break;
228 case 'w': DO_DUMP(unsigned short, 8, " %04x"); break;
229 case 'a':
230 if (sizeof(DWORD_PTR) == 4)
232 DO_DUMP(DWORD_PTR, 4, " %8.8lx");
234 else
236 DO_DUMP(DWORD_PTR, 2, " %16.16lx");
238 break;
239 case 'c': DO_DUMP2(char, 32, " %c", (_v < 0x20) ? ' ' : _v); break;
240 case 'b': DO_DUMP2(char, 16, " %02x", (_v) & 0xff); break;
244 BOOL memory_get_string(struct dbg_process* pcs, void* addr, BOOL in_debuggee,
245 BOOL unicode, char* buffer, int size)
247 SIZE_T sz;
248 WCHAR* buffW;
250 buffer[0] = 0;
251 if (!addr) return FALSE;
252 if (in_debuggee)
254 BOOL ret;
256 if (!unicode) ret = pcs->process_io->read(pcs->handle, addr, buffer, size, &sz);
257 else
259 buffW = HeapAlloc(GetProcessHeap(), 0, size * sizeof(WCHAR));
260 ret = pcs->process_io->read(pcs->handle, addr, buffW, size * sizeof(WCHAR), &sz);
261 WideCharToMultiByte(CP_ACP, 0, buffW, sz / sizeof(WCHAR), buffer, size,
262 NULL, NULL);
263 HeapFree(GetProcessHeap(), 0, buffW);
265 if (size) buffer[size-1] = 0;
266 return ret;
268 else
270 lstrcpynA(buffer, addr, size);
272 return TRUE;
275 BOOL memory_get_string_indirect(struct dbg_process* pcs, void* addr, BOOL unicode, WCHAR* buffer, int size)
277 void* ad;
278 SIZE_T sz;
280 buffer[0] = 0;
281 if (addr &&
282 pcs->process_io->read(pcs->handle, addr, &ad, sizeof(ad), &sz) && sz == sizeof(ad) && ad)
284 LPSTR buff;
285 BOOL ret;
287 if (unicode)
288 ret = pcs->process_io->read(pcs->handle, ad, buffer, size * sizeof(WCHAR), &sz) && sz != 0;
289 else
291 if ((buff = HeapAlloc(GetProcessHeap(), 0, size)))
293 ret = pcs->process_io->read(pcs->handle, ad, buff, size, &sz) && sz != 0;
294 MultiByteToWideChar(CP_ACP, 0, buff, sz, buffer, size);
295 HeapFree(GetProcessHeap(), 0, buff);
297 else ret = FALSE;
299 if (size) buffer[size-1] = 0;
300 return ret;
302 return FALSE;
306 * Convert an address offset to hex string. If mode == 32, treat offset as
307 * 32 bits (discard upper 32 bits), if mode == 64 use all 64 bits, if mode == 0
308 * treat as either 32 or 64 bits, depending on whether we're running as
309 * Wine32 or Wine64.
311 char* memory_offset_to_string(char *str, DWORD64 offset, unsigned mode)
313 if (mode != 32 && mode != 64)
315 #ifdef _WIN64
316 mode = 64;
317 #else
318 mode = 32;
319 #endif
322 if (mode == 32)
323 sprintf(str, "0x%08x", (unsigned int) offset);
324 else
325 sprintf(str, "0x%08x%08x", (unsigned int)(offset >> 32),
326 (unsigned int)offset);
328 return str;
331 static void dbg_print_longlong(LONGLONG sv, BOOL is_signed)
333 char tmp[24], *ptr = tmp + sizeof(tmp) - 1;
334 ULONGLONG uv, div;
335 *ptr = '\0';
336 if (is_signed && sv < 0) uv = -sv;
337 else { uv = sv; is_signed = FALSE; }
338 for (div = 10; uv; div *= 10, uv /= 10)
339 *--ptr = '0' + (uv % 10);
340 if (ptr == tmp + sizeof(tmp) - 1) *--ptr = '0';
341 if (is_signed) *--ptr = '-';
342 dbg_printf("%s", ptr);
345 static void dbg_print_hex(ULONGLONG sv)
347 if (!sv)
349 dbg_printf("0");
350 return;
353 if (sv >> 32)
354 dbg_printf("0x%lx%08lx", (unsigned long)(sv >> 32), (unsigned long)sv);
355 else
356 dbg_printf("0x%04lx", (unsigned long)sv);
359 static void print_typed_basic(const struct dbg_lvalue* lvalue)
361 LONGLONG val_int;
362 void* val_ptr;
363 long double val_real;
364 DWORD64 size64;
365 DWORD tag, size, count, bt;
366 struct dbg_type type = lvalue->type;
367 struct dbg_type sub_type;
368 struct dbg_lvalue sub_lvalue;
370 if (!types_get_real_type(&type, &tag)) return;
372 switch (tag)
374 case SymTagBaseType:
375 if (!types_get_info(&type, TI_GET_LENGTH, &size64) ||
376 !types_get_info(&type, TI_GET_BASETYPE, &bt))
378 WINE_ERR("Couldn't get information\n");
379 RaiseException(DEBUG_STATUS_INTERNAL_ERROR, 0, 0, NULL);
381 size = (DWORD)size64;
382 switch (bt)
384 case btInt:
385 case btLong:
386 if (!be_cpu->fetch_integer(lvalue, size, TRUE, &val_int)) return;
387 if (size == 1) goto print_char;
388 dbg_print_hex(val_int);
389 break;
390 case btUInt:
391 case btULong:
392 if (!be_cpu->fetch_integer(lvalue, size, FALSE, &val_int)) return;
393 dbg_print_hex(val_int);
394 break;
395 case btFloat:
396 if (!be_cpu->fetch_float(lvalue, size, &val_real)) return;
397 dbg_printf("%Lf", val_real);
398 break;
399 case btChar:
400 if (!be_cpu->fetch_integer(lvalue, size, TRUE, &val_int)) return;
401 /* FIXME: should do the same for a Unicode character (size == 2) */
402 print_char:
403 if (size == 1 && (val_int < 0x20 || val_int > 0x80))
404 dbg_printf("%d", (int)val_int);
405 else if (size == 2)
407 WCHAR wch = (WCHAR)val_int;
408 dbg_outputW(&wch, 1);
410 else
411 dbg_printf("'%c'", (char)val_int);
412 break;
413 case btBool:
414 if (!be_cpu->fetch_integer(lvalue, size, TRUE, &val_int)) return;
415 dbg_printf("%s", val_int ? "true" : "false");
416 break;
417 default:
418 WINE_FIXME("Unsupported basetype %u\n", bt);
419 break;
421 break;
422 case SymTagPointerType:
423 if (!types_array_index(lvalue, 0, &sub_lvalue))
425 dbg_printf("Internal symbol error: unable to access memory location %p",
426 memory_to_linear_addr(&lvalue->addr));
427 break;
429 val_ptr = memory_to_linear_addr(&sub_lvalue.addr);
430 if (types_get_real_type(&sub_lvalue.type, &tag) && tag == SymTagBaseType &&
431 types_get_info(&sub_lvalue.type, TI_GET_BASETYPE, &bt) &&
432 types_get_info(&sub_lvalue.type, TI_GET_LENGTH, &size64))
434 char buffer[1024];
436 if (!val_ptr) dbg_printf("0x0");
437 else if (((bt == btChar || bt == btInt) && size64 == 1) || (bt == btUInt && size64 == 2))
439 if (memory_get_string(dbg_curr_process, val_ptr, sub_lvalue.cookie == DLV_TARGET,
440 size64 == 2, buffer, sizeof(buffer)))
441 dbg_printf("\"%s\"", buffer);
442 else
443 dbg_printf("*** invalid address %p ***", val_ptr);
444 break;
447 dbg_printf("%p", val_ptr);
448 break;
449 case SymTagArrayType:
450 case SymTagUDT:
451 if (!memory_read_value(lvalue, sizeof(val_ptr), &val_ptr)) return;
452 dbg_printf("%p", val_ptr);
453 break;
454 case SymTagEnum:
456 BOOL ok = FALSE;
458 /* FIXME: it depends on underlying type for enums
459 * (not supported yet in dbghelp)
460 * Assuming 4 as for an int
462 if (!be_cpu->fetch_integer(lvalue, 4, TRUE, &val_int)) return;
464 if (types_get_info(&type, TI_GET_CHILDRENCOUNT, &count))
466 char buffer[sizeof(TI_FINDCHILDREN_PARAMS) + 256 * sizeof(DWORD)];
467 TI_FINDCHILDREN_PARAMS* fcp = (TI_FINDCHILDREN_PARAMS*)buffer;
468 WCHAR* ptr;
469 char tmp[256];
470 VARIANT variant;
471 int i;
473 fcp->Start = 0;
474 while (count)
476 fcp->Count = min(count, 256);
477 if (types_get_info(&type, TI_FINDCHILDREN, fcp))
479 sub_type.module = type.module;
480 for (i = 0; i < min(fcp->Count, count); i++)
482 sub_type.id = fcp->ChildId[i];
483 if (!types_get_info(&sub_type, TI_GET_VALUE, &variant))
484 continue;
485 switch (variant.n1.n2.vt)
487 case VT_I4: ok = (val_int == variant.n1.n2.n3.lVal); break;
488 default: WINE_FIXME("Unsupported variant type (%u)\n", variant.n1.n2.vt);
490 if (ok)
492 ptr = NULL;
493 types_get_info(&sub_type, TI_GET_SYMNAME, &ptr);
494 if (!ptr) continue;
495 WideCharToMultiByte(CP_ACP, 0, ptr, -1, tmp, sizeof(tmp), NULL, NULL);
496 HeapFree(GetProcessHeap(), 0, ptr);
497 dbg_printf("%s", tmp);
498 count = 0; /* so that we'll get away from outter loop */
499 break;
503 count -= min(count, 256);
504 fcp->Start += 256;
507 if (!ok) dbg_print_longlong(val_int, TRUE);
509 break;
510 default:
511 WINE_FIXME("Unsupported tag %u\n", tag);
512 break;
516 /***********************************************************************
517 * print_basic
519 * Implementation of the 'print' command.
521 void print_basic(const struct dbg_lvalue* lvalue, char format)
523 if (lvalue->type.id == dbg_itype_none)
525 dbg_printf("Unable to evaluate expression\n");
526 return;
529 if (format != 0)
531 unsigned size;
532 LONGLONG res = types_extract_as_longlong(lvalue, &size);
533 DWORD hi;
534 WCHAR wch;
536 /* FIXME: this implies i386 byte ordering */
537 switch (format)
539 case 'x':
540 hi = (ULONG64)res >> 32;
541 if (size == 8 && hi)
542 dbg_printf("0x%x%08x", hi, (DWORD)res);
543 else
544 dbg_printf("0x%x", (DWORD)res);
545 return;
547 case 'd':
548 dbg_print_longlong(res, TRUE);
549 dbg_printf("\n");
550 return;
552 case 'c':
553 dbg_printf("%d = '%c'", (char)(res & 0xff), (char)(res & 0xff));
554 return;
556 case 'u':
557 wch = (WCHAR)(res & 0xFFFF);
558 dbg_printf("%d = '", wch);
559 dbg_outputW(&wch, 1);
560 dbg_printf("'");
561 return;
563 case 'i':
564 case 's':
565 case 'w':
566 case 'b':
567 dbg_printf("Format specifier '%c' is meaningless in 'print' command\n", format);
570 if (lvalue->type.id == dbg_itype_segptr)
572 dbg_print_longlong(types_extract_as_longlong(lvalue, NULL), TRUE);
573 dbg_printf("\n");
575 else print_typed_basic(lvalue);
578 void print_bare_address(const ADDRESS64* addr)
580 char hexbuf[MAX_OFFSET_TO_STR_LEN];
582 switch (addr->Mode)
584 case AddrModeFlat:
585 dbg_printf("%s", memory_offset_to_string(hexbuf, addr->Offset, 0));
586 break;
587 case AddrModeReal:
588 case AddrMode1616:
589 dbg_printf("0x%04x:0x%04x", addr->Segment, (unsigned) addr->Offset);
590 break;
591 case AddrMode1632:
592 dbg_printf("0x%04x:%s", addr->Segment,
593 memory_offset_to_string(hexbuf, addr->Offset, 32));
594 break;
595 default:
596 dbg_printf("Unknown mode %x\n", addr->Mode);
597 break;
601 /***********************************************************************
602 * print_address
604 * Print an 16- or 32-bit address, with the nearest symbol if any.
606 void print_address(const ADDRESS64* addr, BOOLEAN with_line)
608 char buffer[sizeof(SYMBOL_INFO) + 256];
609 SYMBOL_INFO* si = (SYMBOL_INFO*)buffer;
610 void* lin = memory_to_linear_addr(addr);
611 DWORD64 disp64;
612 DWORD disp;
614 print_bare_address(addr);
616 si->SizeOfStruct = sizeof(*si);
617 si->MaxNameLen = 256;
618 if (!SymFromAddr(dbg_curr_process->handle, (DWORD_PTR)lin, &disp64, si)) return;
619 dbg_printf(" %s", si->Name);
620 if (disp64) dbg_printf("+0x%lx", (DWORD_PTR)disp64);
621 if (with_line)
623 IMAGEHLP_LINE64 il;
624 IMAGEHLP_MODULE im;
626 il.SizeOfStruct = sizeof(il);
627 if (SymGetLineFromAddr64(dbg_curr_process->handle, (DWORD_PTR)lin, &disp, &il))
628 dbg_printf(" [%s:%u]", il.FileName, il.LineNumber);
629 im.SizeOfStruct = sizeof(im);
630 if (SymGetModuleInfo(dbg_curr_process->handle, (DWORD_PTR)lin, &im))
631 dbg_printf(" in %s", im.ModuleName);
635 BOOL memory_disasm_one_insn(ADDRESS64* addr)
637 char ch;
639 print_address(addr, TRUE);
640 dbg_printf(": ");
641 if (!dbg_read_memory(memory_to_linear_addr(addr), &ch, sizeof(ch)))
643 dbg_printf("-- no code accessible --\n");
644 return FALSE;
646 be_cpu->disasm_one_insn(addr, TRUE);
647 dbg_printf("\n");
648 return TRUE;
651 void memory_disassemble(const struct dbg_lvalue* xstart,
652 const struct dbg_lvalue* xend, int instruction_count)
654 static ADDRESS64 last = {0,0,0};
655 int stop = 0;
656 int i;
658 if (!xstart && !xend)
660 if (!last.Segment && !last.Offset) memory_get_current_pc(&last);
662 else
664 if (xstart)
665 types_extract_as_address(xstart, &last);
666 if (xend)
667 stop = types_extract_as_integer(xend);
669 for (i = 0; (instruction_count == 0 || i < instruction_count) &&
670 (stop == 0 || last.Offset <= stop); i++)
671 memory_disasm_one_insn(&last);
674 BOOL memory_get_register(DWORD regno, DWORD_PTR** value, char* buffer, int len)
676 const struct dbg_internal_var* div;
678 /* negative register values are wine's dbghelp hacks
679 * see dlls/dbghelp/dbghelp_internal.h for the details
681 switch (regno)
683 case -1:
684 if (buffer) snprintf(buffer, len, "<internal error>");
685 return FALSE;
686 case -2:
687 if (buffer) snprintf(buffer, len, "<couldn't compute location>");
688 return FALSE;
689 case -3:
690 if (buffer) snprintf(buffer, len, "<is not available>");
691 return FALSE;
692 case -4:
693 if (buffer) snprintf(buffer, len, "<couldn't read memory>");
694 return FALSE;
697 for (div = be_cpu->context_vars; div->name; div++)
699 if (div->val == regno)
701 if (!stack_get_register_frame(div, value))
703 if (buffer) snprintf(buffer, len, "<register %s not accessible in this frame>", div->name);
704 return FALSE;
707 if (buffer) lstrcpynA(buffer, div->name, len);
708 return TRUE;
711 if (buffer) snprintf(buffer, len, "<unknown register %u>", regno);
712 return FALSE;