2 * Debugger memory handling
4 * Copyright 1993 Eric Youngdale
5 * Copyright 1995 Alexandre Julliard
6 * Copyright 2000-2004 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
24 #include "wine/port.h"
31 #include "wine/debug.h"
33 WINE_DEFAULT_DEBUG_CHANNEL(winedbg);
35 void* be_cpu_linearize(HANDLE hThread, const ADDRESS* addr)
37 assert(addr->Mode == AddrModeFlat);
38 return (void*)addr->Offset;
41 unsigned be_cpu_build_addr(HANDLE hThread, const CONTEXT* ctx, ADDRESS* addr,
42 unsigned seg, unsigned long offset)
44 addr->Mode = AddrModeFlat;
45 addr->Segment = 0; /* don't need segment */
46 addr->Offset = offset;
50 void* memory_to_linear_addr(const ADDRESS* addr)
52 return be_cpu->linearize(dbg_curr_thread->handle, addr);
55 BOOL memory_get_current_pc(ADDRESS* 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(ADDRESS* 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(ADDRESS* 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 void memory_report_invalid_addr(const void* addr)
80 address.Mode = AddrModeFlat;
82 address.Offset = (unsigned long)addr;
83 dbg_printf("*** Invalid address ");
84 print_address(&address, FALSE);
88 /***********************************************************************
91 * Read a memory value.
93 BOOL memory_read_value(const struct dbg_lvalue* lvalue, DWORD size, void* result)
95 if (lvalue->cookie == DLV_TARGET)
97 if (!dbg_read_memory_verbose(memory_to_linear_addr(&lvalue->addr), result, size))
102 if (!lvalue->addr.Offset) return FALSE;
103 memcpy(result, (void*)lvalue->addr.Offset, size);
108 /***********************************************************************
111 * Store a value in memory.
113 BOOL memory_write_value(const struct dbg_lvalue* lvalue, DWORD size, void* value)
117 DWORD linear = (DWORD)memory_to_linear_addr(&lvalue->addr);
120 types_get_info(&lvalue->type, TI_GET_LENGTH, &os);
123 /* FIXME: only works on little endian systems */
124 if (lvalue->cookie == DLV_TARGET)
126 ret = dbg_write_memory_verbose((void*)linear, value, size);
130 memcpy((void*)lvalue->addr.Offset, value, size);
135 /***********************************************************************
138 * Implementation of the 'x' command.
140 void memory_examine(const struct dbg_lvalue *lvalue, int count, char format)
147 if (lvalue->type.id == dbg_itype_none) addr = lvalue->addr;
150 addr.Mode = AddrModeFlat;
151 addr.Offset = types_extract_as_integer( lvalue );
153 linear = memory_to_linear_addr( &addr );
155 if (format != 'i' && count > 1)
157 print_address(&addr, FALSE);
164 if (count == 1) count = 256;
165 memory_get_string(dbg_curr_process->handle, linear,
166 TRUE, TRUE, buffer, min(count, sizeof(buffer)));
167 dbg_printf("%s\n", buffer);
170 if (count == 1) count = 256;
171 memory_get_string(dbg_curr_process->handle, linear,
172 TRUE, FALSE, buffer, min(count, sizeof(buffer)));
173 dbg_printf("%s\n", buffer);
176 while (count-- && memory_disasm_one_insn(&addr));
182 if (!dbg_read_memory_verbose(linear, &guid, sizeof(guid))) break;
183 dbg_printf("{%08lx-%04x-%04x-%02x%02x-%02x%02x%02x%02x%02x%02x}\n",
184 guid.Data1, guid.Data2, guid.Data3,
185 guid.Data4[0], guid.Data4[1], guid.Data4[2], guid.Data4[3],
186 guid.Data4[4], guid.Data4[5], guid.Data4[6], guid.Data4[7]);
187 linear = (char*)linear + sizeof(guid);
188 addr.Offset += sizeof(guid);
191 print_address(&addr, FALSE);
197 #define DO_DUMP2(_t,_l,_f,_vv) { \
199 for (i = 0; i < count; i++) { \
200 if (!dbg_read_memory_verbose(linear, &_v, \
201 sizeof(_t))) break; \
202 dbg_printf(_f, (_vv)); \
203 addr.Offset += sizeof(_t); \
204 linear = (char*)linear + sizeof(_t); \
205 if ((i % (_l)) == (_l) - 1 && i != count - 1) \
208 print_address(&addr, FALSE); \
215 #define DO_DUMP(_t,_l,_f) DO_DUMP2(_t,_l,_f,_v)
217 case 'x': DO_DUMP(int, 4, " %8.8x");
218 case 'd': DO_DUMP(unsigned int, 4, " %10d");
219 case 'w': DO_DUMP(unsigned short, 8, " %04x");
220 case 'c': DO_DUMP2(char, 32, " %c", (_v < 0x20) ? ' ' : _v);
221 case 'b': DO_DUMP2(char, 16, " %02x", (_v) & 0xff);
225 BOOL memory_get_string(HANDLE hp, void* addr, BOOL in_debuggee, BOOL unicode,
226 char* buffer, int size)
232 if (!addr) return FALSE;
235 if (!unicode) return ReadProcessMemory(hp, addr, buffer, size, &sz);
237 buffW = HeapAlloc(GetProcessHeap(), 0, size * sizeof(WCHAR));
238 ReadProcessMemory(hp, addr, buffW, size * sizeof(WCHAR), &sz);
239 WideCharToMultiByte(CP_ACP, 0, buffW, sz / sizeof(WCHAR), buffer, size,
241 HeapFree(GetProcessHeap(), 0, buffW);
245 strncpy(buffer, addr, size);
246 buffer[size - 1] = 0;
251 BOOL memory_get_string_indirect(HANDLE hp, void* addr, BOOL unicode, char* buffer, int size)
258 ReadProcessMemory(hp, addr, &ad, sizeof(ad), &sz) && sz == sizeof(ad) && ad)
260 return memory_get_string(hp, ad, TRUE, unicode, buffer, size);
265 static void print_typed_basic(const struct dbg_lvalue* lvalue)
267 long long int val_int;
269 long double val_real;
270 DWORD tag, size, count, bt;
271 struct dbg_type rtype;
273 if (lvalue->type.id == dbg_itype_none ||
274 !types_get_info(&lvalue->type, TI_GET_SYMTAG, &tag))
280 if (!types_get_info(&lvalue->type, TI_GET_LENGTH, &size) ||
281 !types_get_info(&lvalue->type, TI_GET_BASETYPE, &bt))
283 WINE_ERR("Couldn't get information\n");
284 RaiseException(DEBUG_STATUS_INTERNAL_ERROR, 0, 0, NULL);
290 if (!be_cpu->fetch_integer(lvalue, size, TRUE, &val_int)) return;
291 dbg_printf("%lld", val_int);
294 if (!be_cpu->fetch_integer(lvalue, size, FALSE, &val_int)) return;
295 dbg_printf("%llu", val_int);
298 if (!be_cpu->fetch_float(lvalue, size, &val_real)) return;
299 dbg_printf("%Lf", val_real);
302 if (!be_cpu->fetch_integer(lvalue, size, TRUE, &val_int)) return;
303 /* FIXME: should do the same for a Unicode character (size == 2) */
304 if (size == 1 && (val_int < 0x20 || val_int > 0x80))
305 dbg_printf("%d", (int)val_int);
307 dbg_printf("'%c'", (char)val_int);
310 WINE_FIXME("Unsupported basetype %lu\n", bt);
314 case SymTagPointerType:
315 if (!memory_read_value(lvalue, sizeof(void*), &val_ptr)) return;
317 if (!types_get_info(&lvalue->type, TI_GET_TYPE, &rtype.id) ||
318 rtype.id == dbg_itype_none)
320 dbg_printf("Internal symbol error: unable to access memory location %p", val_ptr);
323 rtype.module = lvalue->type.module;
324 if (types_get_info(&rtype, TI_GET_SYMTAG, &tag) && tag == SymTagBaseType &&
325 types_get_info(&rtype, TI_GET_BASETYPE, &bt) && bt == btChar &&
326 types_get_info(&rtype, TI_GET_LENGTH, &size))
330 memory_get_string(dbg_curr_process->handle, val_ptr,
331 lvalue->cookie == DLV_TARGET,
332 size == 2, buffer, sizeof(buffer));
333 dbg_printf("\"%s\"", buffer);
335 else dbg_printf("%p", val_ptr);
337 case SymTagArrayType:
339 assert(lvalue->cookie == DLV_TARGET);
340 if (!memory_read_value(lvalue, sizeof(val_ptr), &val_ptr)) return;
341 dbg_printf("%p", val_ptr);
347 assert(lvalue->cookie == DLV_TARGET);
348 /* FIXME: it depends on underlying type for enums
349 * (not supported yet in dbghelp)
350 * Assuming 4 as for an int
352 if (!be_cpu->fetch_integer(lvalue, 4, TRUE, &val_int)) return;
354 if (types_get_info(&lvalue->type, TI_GET_CHILDRENCOUNT, &count))
356 char buffer[sizeof(TI_FINDCHILDREN_PARAMS) + 256 * sizeof(DWORD)];
357 TI_FINDCHILDREN_PARAMS* fcp = (TI_FINDCHILDREN_PARAMS*)buffer;
362 struct dbg_type type;
367 fcp->Count = min(count, 256);
368 if (types_get_info(&lvalue->type, TI_FINDCHILDREN, fcp))
370 type.module = lvalue->type.module;
371 for (i = 0; i < min(fcp->Count, count); i++)
373 type.id = fcp->ChildId[i];
374 if (!types_get_info(&type, TI_GET_VALUE, &variant))
376 switch (variant.n1.n2.vt)
378 case VT_I4: ok = (val_int == variant.n1.n2.n3.lVal); break;
379 default: WINE_FIXME("Unsupported variant type (%u)\n", variant.n1.n2.vt);
384 types_get_info(&type, TI_GET_SYMNAME, &ptr);
386 WideCharToMultiByte(CP_ACP, 0, ptr, -1, tmp, sizeof(tmp), NULL, NULL);
387 HeapFree(GetProcessHeap(), 0, ptr);
388 dbg_printf("%s", tmp);
389 count = 0; /* so that we'll get away from outter loop */
395 count -= min(count, 256);
398 if (!ok) dbg_printf("%lld", val_int);
402 WINE_FIXME("Unsupported tag %lu\n", tag);
407 /***********************************************************************
410 * Implementation of the 'print' command.
412 void print_basic(const struct dbg_lvalue* lvalue, int count, char format)
416 if (lvalue->type.id == dbg_itype_none)
418 dbg_printf("Unable to evaluate expression\n");
422 res = types_extract_as_integer(lvalue);
424 /* FIXME: this implies i386 byte ordering */
428 if (lvalue->addr.Mode != AddrModeFlat)
429 dbg_printf("0x%04lx", res);
431 dbg_printf("0x%08lx", res);
435 dbg_printf("%ld\n", res);
439 dbg_printf("%d = '%c'", (char)(res & 0xff), (char)(res & 0xff));
444 WCHAR wch = (WCHAR)(res & 0xFFFF);
445 dbg_printf("%d = '", wch);
446 dbg_outputW(&wch, 1);
455 dbg_printf("Format specifier '%c' is meaningless in 'print' command\n", format);
457 print_typed_basic(lvalue);
462 void print_bare_address(const ADDRESS* addr)
467 dbg_printf("0x%08lx", addr->Offset);
471 dbg_printf("0x%04x:0x%04lx", addr->Segment, addr->Offset);
474 dbg_printf("0x%04x:0x%08lx", addr->Segment, addr->Offset);
477 dbg_printf("Unknown mode %x\n", addr->Mode);
482 /***********************************************************************
485 * Print an 16- or 32-bit address, with the nearest symbol if any.
487 void print_address(const ADDRESS* addr, BOOLEAN with_line)
489 char buffer[sizeof(SYMBOL_INFO) + 256];
490 SYMBOL_INFO* si = (SYMBOL_INFO*)buffer;
491 void* lin = memory_to_linear_addr(addr);
495 print_bare_address(addr);
497 si->SizeOfStruct = sizeof(*si);
498 si->MaxNameLen = 256;
499 if (!SymFromAddr(dbg_curr_process->handle, (DWORD_PTR)lin, &disp64, si)) return;
500 dbg_printf(" %s", si->Name);
501 if (disp64) dbg_printf("+0x%lx", (DWORD_PTR)disp64);
507 il.SizeOfStruct = sizeof(il);
508 if (SymGetLineFromAddr(dbg_curr_process->handle, (DWORD_PTR)lin, &disp, &il))
509 dbg_printf(" [%s:%lu]", il.FileName, il.LineNumber);
510 im.SizeOfStruct = sizeof(im);
511 if (SymGetModuleInfo(dbg_curr_process->handle, (DWORD_PTR)lin, &im))
512 dbg_printf(" in %s", im.ModuleName);
522 static BOOL WINAPI sym_enum_cb(SYMBOL_INFO* sym_info, ULONG size, void* user)
524 struct sym_enum* se = (struct sym_enum*)user;
529 if ((sym_info->Flags & (SYMFLAG_PARAMETER|SYMFLAG_FRAMEREL)) == (SYMFLAG_PARAMETER|SYMFLAG_FRAMEREL))
531 struct dbg_type type;
533 if (se->tmp[0]) strcat(se->tmp, ", ");
535 type.module = sym_info->ModBase;
536 type.id = sym_info->TypeIndex;
537 types_get_info(&type, TI_GET_OFFSET, &offset);
539 dbg_read_memory_verbose((char*)addr, &val, sizeof(val));
540 sprintf(se->tmp + strlen(se->tmp), "%s=0x%x", sym_info->Name, val);
545 void print_addr_and_args(const ADDRESS* pc, const ADDRESS* frame)
547 char buffer[sizeof(SYMBOL_INFO) + 256];
548 SYMBOL_INFO* si = (SYMBOL_INFO*)buffer;
549 IMAGEHLP_STACK_FRAME isf;
554 print_bare_address(pc);
556 isf.InstructionOffset = (DWORD_PTR)memory_to_linear_addr(pc);
557 isf.FrameOffset = (DWORD_PTR)memory_to_linear_addr(frame);
559 /* grab module where symbol is. If we don't have a module, we cannot print more */
560 im.SizeOfStruct = sizeof(im);
561 if (!SymGetModuleInfo(dbg_curr_process->handle, isf.InstructionOffset, &im))
564 si->SizeOfStruct = sizeof(*si);
565 si->MaxNameLen = 256;
566 if (SymFromAddr(dbg_curr_process->handle, isf.InstructionOffset, &disp64, si))
572 dbg_printf(" %s", si->Name);
573 if (disp) dbg_printf("+0x%lx", (DWORD_PTR)disp64);
575 SymSetContext(dbg_curr_process->handle, &isf, NULL);
577 se.frame = isf.FrameOffset;
579 SymEnumSymbols(dbg_curr_process->handle, 0, NULL, sym_enum_cb, &se);
580 if (tmp[0]) dbg_printf("(%s)", tmp);
582 il.SizeOfStruct = sizeof(il);
583 if (SymGetLineFromAddr(dbg_curr_process->handle, isf.InstructionOffset,
585 dbg_printf(" [%s:%lu]", il.FileName, il.LineNumber);
586 dbg_printf(" in %s", im.ModuleName);
588 else dbg_printf(" in %s (+0x%lx)",
589 im.ModuleName, (DWORD_PTR)(isf.InstructionOffset - im.BaseOfImage));
592 BOOL memory_disasm_one_insn(ADDRESS* addr)
596 print_address(addr, TRUE);
598 if (!dbg_read_memory(memory_to_linear_addr(addr), &ch, sizeof(ch)))
600 dbg_printf("-- no code accessible --\n");
603 be_cpu->disasm_one_insn(addr, TRUE);
608 void memory_disassemble(const struct dbg_lvalue* xstart,
609 const struct dbg_lvalue* xend, int instruction_count)
611 static ADDRESS last = {0,0,0};
615 if (!xstart && !xend)
617 if (!last.Segment && !last.Offset) memory_get_current_pc(&last);
623 last.Mode = AddrModeFlat;
624 last.Offset = types_extract_as_integer(xstart);
627 stop = types_extract_as_integer(xend);
629 for (i = 0; (instruction_count == 0 || i < instruction_count) &&
630 (stop == 0 || last.Offset <= stop); i++)
631 memory_disasm_one_insn(&last);