1 //===-- Address.cpp ---------------------------------------------*- C++ -*-===// 2 // 3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. 4 // See https://llvm.org/LICENSE.txt for license information. 5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception 6 // 7 //===----------------------------------------------------------------------===// 8 9 #include "lldb/Core/Address.h" 10 #include "lldb/Core/DumpDataExtractor.h" 11 #include "lldb/Core/Module.h" 12 #include "lldb/Core/ModuleList.h" 13 #include "lldb/Core/Section.h" 14 #include "lldb/Symbol/Block.h" 15 #include "lldb/Symbol/Declaration.h" 16 #include "lldb/Symbol/LineEntry.h" 17 #include "lldb/Symbol/ObjectFile.h" 18 #include "lldb/Symbol/Symbol.h" 19 #include "lldb/Symbol/SymbolContext.h" 20 #include "lldb/Symbol/SymbolVendor.h" 21 #include "lldb/Symbol/Symtab.h" 22 #include "lldb/Symbol/Type.h" 23 #include "lldb/Symbol/Variable.h" 24 #include "lldb/Symbol/VariableList.h" 25 #include "lldb/Target/ExecutionContext.h" 26 #include "lldb/Target/ExecutionContextScope.h" 27 #include "lldb/Target/Process.h" 28 #include "lldb/Target/SectionLoadList.h" 29 #include "lldb/Target/Target.h" 30 #include "lldb/Utility/ConstString.h" 31 #include "lldb/Utility/DataExtractor.h" 32 #include "lldb/Utility/Endian.h" 33 #include "lldb/Utility/FileSpec.h" 34 #include "lldb/Utility/Status.h" 35 #include "lldb/Utility/Stream.h" 36 #include "lldb/Utility/StreamString.h" 37 38 #include "llvm/ADT/StringRef.h" 39 #include "llvm/ADT/Triple.h" 40 #include "llvm/Support/Compiler.h" 41 42 #include <cstdint> 43 #include <memory> 44 #include <vector> 45 46 #include <assert.h> 47 #include <inttypes.h> 48 #include <string.h> 49 50 namespace lldb_private { 51 class CompileUnit; 52 } 53 namespace lldb_private { 54 class Function; 55 } 56 57 using namespace lldb; 58 using namespace lldb_private; 59 60 static size_t ReadBytes(ExecutionContextScope *exe_scope, 61 const Address &address, void *dst, size_t dst_len) { 62 if (exe_scope == nullptr) 63 return 0; 64 65 TargetSP target_sp(exe_scope->CalculateTarget()); 66 if (target_sp) { 67 Status error; 68 bool prefer_file_cache = false; 69 return target_sp->ReadMemory(address, prefer_file_cache, dst, dst_len, 70 error); 71 } 72 return 0; 73 } 74 75 static bool GetByteOrderAndAddressSize(ExecutionContextScope *exe_scope, 76 const Address &address, 77 ByteOrder &byte_order, 78 uint32_t &addr_size) { 79 byte_order = eByteOrderInvalid; 80 addr_size = 0; 81 if (exe_scope == nullptr) 82 return false; 83 84 TargetSP target_sp(exe_scope->CalculateTarget()); 85 if (target_sp) { 86 byte_order = target_sp->GetArchitecture().GetByteOrder(); 87 addr_size = target_sp->GetArchitecture().GetAddressByteSize(); 88 } 89 90 if (byte_order == eByteOrderInvalid || addr_size == 0) { 91 ModuleSP module_sp(address.GetModule()); 92 if (module_sp) { 93 byte_order = module_sp->GetArchitecture().GetByteOrder(); 94 addr_size = module_sp->GetArchitecture().GetAddressByteSize(); 95 } 96 } 97 return byte_order != eByteOrderInvalid && addr_size != 0; 98 } 99 100 static uint64_t ReadUIntMax64(ExecutionContextScope *exe_scope, 101 const Address &address, uint32_t byte_size, 102 bool &success) { 103 uint64_t uval64 = 0; 104 if (exe_scope == nullptr || byte_size > sizeof(uint64_t)) { 105 success = false; 106 return 0; 107 } 108 uint64_t buf = 0; 109 110 success = ReadBytes(exe_scope, address, &buf, byte_size) == byte_size; 111 if (success) { 112 ByteOrder byte_order = eByteOrderInvalid; 113 uint32_t addr_size = 0; 114 if (GetByteOrderAndAddressSize(exe_scope, address, byte_order, addr_size)) { 115 DataExtractor data(&buf, sizeof(buf), byte_order, addr_size); 116 lldb::offset_t offset = 0; 117 uval64 = data.GetU64(&offset); 118 } else 119 success = false; 120 } 121 return uval64; 122 } 123 124 static bool ReadAddress(ExecutionContextScope *exe_scope, 125 const Address &address, uint32_t pointer_size, 126 Address &deref_so_addr) { 127 if (exe_scope == nullptr) 128 return false; 129 130 bool success = false; 131 addr_t deref_addr = ReadUIntMax64(exe_scope, address, pointer_size, success); 132 if (success) { 133 ExecutionContext exe_ctx; 134 exe_scope->CalculateExecutionContext(exe_ctx); 135 // If we have any sections that are loaded, try and resolve using the 136 // section load list 137 Target *target = exe_ctx.GetTargetPtr(); 138 if (target && !target->GetSectionLoadList().IsEmpty()) { 139 if (target->GetSectionLoadList().ResolveLoadAddress(deref_addr, 140 deref_so_addr)) 141 return true; 142 } else { 143 // If we were not running, yet able to read an integer, we must have a 144 // module 145 ModuleSP module_sp(address.GetModule()); 146 147 assert(module_sp); 148 if (module_sp->ResolveFileAddress(deref_addr, deref_so_addr)) 149 return true; 150 } 151 152 // We couldn't make "deref_addr" into a section offset value, but we were 153 // able to read the address, so we return a section offset address with no 154 // section and "deref_addr" as the offset (address). 155 deref_so_addr.SetRawAddress(deref_addr); 156 return true; 157 } 158 return false; 159 } 160 161 static bool DumpUInt(ExecutionContextScope *exe_scope, const Address &address, 162 uint32_t byte_size, Stream *strm) { 163 if (exe_scope == nullptr || byte_size == 0) 164 return false; 165 std::vector<uint8_t> buf(byte_size, 0); 166 167 if (ReadBytes(exe_scope, address, &buf[0], buf.size()) == buf.size()) { 168 ByteOrder byte_order = eByteOrderInvalid; 169 uint32_t addr_size = 0; 170 if (GetByteOrderAndAddressSize(exe_scope, address, byte_order, addr_size)) { 171 DataExtractor data(&buf.front(), buf.size(), byte_order, addr_size); 172 173 DumpDataExtractor(data, strm, 174 0, // Start offset in "data" 175 eFormatHex, // Print as characters 176 buf.size(), // Size of item 177 1, // Items count 178 UINT32_MAX, // num per line 179 LLDB_INVALID_ADDRESS, // base address 180 0, // bitfield bit size 181 0); // bitfield bit offset 182 183 return true; 184 } 185 } 186 return false; 187 } 188 189 static size_t ReadCStringFromMemory(ExecutionContextScope *exe_scope, 190 const Address &address, Stream *strm) { 191 if (exe_scope == nullptr) 192 return 0; 193 const size_t k_buf_len = 256; 194 char buf[k_buf_len + 1]; 195 buf[k_buf_len] = '\0'; // NULL terminate 196 197 // Byte order and address size don't matter for C string dumping.. 198 DataExtractor data(buf, sizeof(buf), endian::InlHostByteOrder(), 4); 199 size_t total_len = 0; 200 size_t bytes_read; 201 Address curr_address(address); 202 strm->PutChar('"'); 203 while ((bytes_read = ReadBytes(exe_scope, curr_address, buf, k_buf_len)) > 204 0) { 205 size_t len = strlen(buf); 206 if (len == 0) 207 break; 208 if (len > bytes_read) 209 len = bytes_read; 210 211 DumpDataExtractor(data, strm, 212 0, // Start offset in "data" 213 eFormatChar, // Print as characters 214 1, // Size of item (1 byte for a char!) 215 len, // How many bytes to print? 216 UINT32_MAX, // num per line 217 LLDB_INVALID_ADDRESS, // base address 218 0, // bitfield bit size 219 220 0); // bitfield bit offset 221 222 total_len += bytes_read; 223 224 if (len < k_buf_len) 225 break; 226 curr_address.SetOffset(curr_address.GetOffset() + bytes_read); 227 } 228 strm->PutChar('"'); 229 return total_len; 230 } 231 232 Address::Address(lldb::addr_t abs_addr) : m_section_wp(), m_offset(abs_addr) {} 233 234 Address::Address(addr_t address, const SectionList *section_list) 235 : m_section_wp(), m_offset(LLDB_INVALID_ADDRESS) { 236 ResolveAddressUsingFileSections(address, section_list); 237 } 238 239 const Address &Address::operator=(const Address &rhs) { 240 if (this != &rhs) { 241 m_section_wp = rhs.m_section_wp; 242 m_offset = rhs.m_offset; 243 } 244 return *this; 245 } 246 247 bool Address::ResolveAddressUsingFileSections(addr_t file_addr, 248 const SectionList *section_list) { 249 if (section_list) { 250 SectionSP section_sp( 251 section_list->FindSectionContainingFileAddress(file_addr)); 252 m_section_wp = section_sp; 253 if (section_sp) { 254 assert(section_sp->ContainsFileAddress(file_addr)); 255 m_offset = file_addr - section_sp->GetFileAddress(); 256 return true; // Successfully transformed addr into a section offset 257 // address 258 } 259 } 260 m_offset = file_addr; 261 return false; // Failed to resolve this address to a section offset value 262 } 263 264 /// if "addr_range_ptr" is not NULL, then fill in with the address range of the function. 265 bool Address::ResolveFunctionScope(SymbolContext &sym_ctx, 266 AddressRange *addr_range_ptr) { 267 constexpr SymbolContextItem resolve_scope = 268 eSymbolContextFunction | eSymbolContextSymbol; 269 270 if (!(CalculateSymbolContext(&sym_ctx, resolve_scope) & resolve_scope)) { 271 if (addr_range_ptr) 272 addr_range_ptr->Clear(); 273 return false; 274 } 275 276 if (!addr_range_ptr) 277 return true; 278 279 return sym_ctx.GetAddressRange(resolve_scope, 0, false, *addr_range_ptr); 280 } 281 282 ModuleSP Address::GetModule() const { 283 lldb::ModuleSP module_sp; 284 SectionSP section_sp(GetSection()); 285 if (section_sp) 286 module_sp = section_sp->GetModule(); 287 return module_sp; 288 } 289 290 addr_t Address::GetFileAddress() const { 291 SectionSP section_sp(GetSection()); 292 if (section_sp) { 293 addr_t sect_file_addr = section_sp->GetFileAddress(); 294 if (sect_file_addr == LLDB_INVALID_ADDRESS) { 295 // Section isn't resolved, we can't return a valid file address 296 return LLDB_INVALID_ADDRESS; 297 } 298 // We have a valid file range, so we can return the file based address by 299 // adding the file base address to our offset 300 return sect_file_addr + m_offset; 301 } else if (SectionWasDeletedPrivate()) { 302 // Used to have a valid section but it got deleted so the offset doesn't 303 // mean anything without the section 304 return LLDB_INVALID_ADDRESS; 305 } 306 // No section, we just return the offset since it is the value in this case 307 return m_offset; 308 } 309 310 addr_t Address::GetLoadAddress(Target *target) const { 311 SectionSP section_sp(GetSection()); 312 if (section_sp) { 313 if (target) { 314 addr_t sect_load_addr = section_sp->GetLoadBaseAddress(target); 315 316 if (sect_load_addr != LLDB_INVALID_ADDRESS) { 317 // We have a valid file range, so we can return the file based address 318 // by adding the file base address to our offset 319 return sect_load_addr + m_offset; 320 } 321 } 322 } else if (SectionWasDeletedPrivate()) { 323 // Used to have a valid section but it got deleted so the offset doesn't 324 // mean anything without the section 325 return LLDB_INVALID_ADDRESS; 326 } else { 327 // We don't have a section so the offset is the load address 328 return m_offset; 329 } 330 // The section isn't resolved or an invalid target was passed in so we can't 331 // return a valid load address. 332 return LLDB_INVALID_ADDRESS; 333 } 334 335 addr_t Address::GetCallableLoadAddress(Target *target, bool is_indirect) const { 336 addr_t code_addr = LLDB_INVALID_ADDRESS; 337 338 if (is_indirect && target) { 339 ProcessSP processSP = target->GetProcessSP(); 340 Status error; 341 if (processSP) { 342 code_addr = processSP->ResolveIndirectFunction(this, error); 343 if (!error.Success()) 344 code_addr = LLDB_INVALID_ADDRESS; 345 } 346 } else { 347 code_addr = GetLoadAddress(target); 348 } 349 350 if (code_addr == LLDB_INVALID_ADDRESS) 351 return code_addr; 352 353 if (target) 354 return target->GetCallableLoadAddress(code_addr, GetAddressClass()); 355 return code_addr; 356 } 357 358 bool Address::SetCallableLoadAddress(lldb::addr_t load_addr, Target *target) { 359 if (SetLoadAddress(load_addr, target)) { 360 if (target) 361 m_offset = target->GetCallableLoadAddress(m_offset, GetAddressClass()); 362 return true; 363 } 364 return false; 365 } 366 367 addr_t Address::GetOpcodeLoadAddress(Target *target, 368 AddressClass addr_class) const { 369 addr_t code_addr = GetLoadAddress(target); 370 if (code_addr != LLDB_INVALID_ADDRESS) { 371 if (addr_class == AddressClass::eInvalid) 372 addr_class = GetAddressClass(); 373 code_addr = target->GetOpcodeLoadAddress(code_addr, addr_class); 374 } 375 return code_addr; 376 } 377 378 bool Address::SetOpcodeLoadAddress(lldb::addr_t load_addr, Target *target, 379 AddressClass addr_class, 380 bool allow_section_end) { 381 if (SetLoadAddress(load_addr, target, allow_section_end)) { 382 if (target) { 383 if (addr_class == AddressClass::eInvalid) 384 addr_class = GetAddressClass(); 385 m_offset = target->GetOpcodeLoadAddress(m_offset, addr_class); 386 } 387 return true; 388 } 389 return false; 390 } 391 392 bool Address::Dump(Stream *s, ExecutionContextScope *exe_scope, DumpStyle style, 393 DumpStyle fallback_style, uint32_t addr_size) const { 394 // If the section was nullptr, only load address is going to work unless we 395 // are trying to deref a pointer 396 SectionSP section_sp(GetSection()); 397 if (!section_sp && style != DumpStyleResolvedPointerDescription) 398 style = DumpStyleLoadAddress; 399 400 ExecutionContext exe_ctx(exe_scope); 401 Target *target = exe_ctx.GetTargetPtr(); 402 // If addr_byte_size is UINT32_MAX, then determine the correct address byte 403 // size for the process or default to the size of addr_t 404 if (addr_size == UINT32_MAX) { 405 if (target) 406 addr_size = target->GetArchitecture().GetAddressByteSize(); 407 else 408 addr_size = sizeof(addr_t); 409 } 410 411 Address so_addr; 412 switch (style) { 413 case DumpStyleInvalid: 414 return false; 415 416 case DumpStyleSectionNameOffset: 417 if (section_sp) { 418 section_sp->DumpName(s); 419 s->Printf(" + %" PRIu64, m_offset); 420 } else { 421 s->Address(m_offset, addr_size); 422 } 423 break; 424 425 case DumpStyleSectionPointerOffset: 426 s->Printf("(Section *)%p + ", static_cast<void *>(section_sp.get())); 427 s->Address(m_offset, addr_size); 428 break; 429 430 case DumpStyleModuleWithFileAddress: 431 if (section_sp) { 432 ModuleSP module_sp = section_sp->GetModule(); 433 if (module_sp) 434 s->Printf("%s[", module_sp->GetFileSpec().GetFilename().AsCString( 435 "<Unknown>")); 436 else 437 s->Printf("%s[", "<Unknown>"); 438 } 439 LLVM_FALLTHROUGH; 440 case DumpStyleFileAddress: { 441 addr_t file_addr = GetFileAddress(); 442 if (file_addr == LLDB_INVALID_ADDRESS) { 443 if (fallback_style != DumpStyleInvalid) 444 return Dump(s, exe_scope, fallback_style, DumpStyleInvalid, addr_size); 445 return false; 446 } 447 s->Address(file_addr, addr_size); 448 if (style == DumpStyleModuleWithFileAddress && section_sp) 449 s->PutChar(']'); 450 } break; 451 452 case DumpStyleLoadAddress: { 453 addr_t load_addr = GetLoadAddress(target); 454 455 /* 456 * MIPS: 457 * Display address in compressed form for MIPS16 or microMIPS 458 * if the address belongs to AddressClass::eCodeAlternateISA. 459 */ 460 if (target) { 461 const llvm::Triple::ArchType llvm_arch = 462 target->GetArchitecture().GetMachine(); 463 if (llvm_arch == llvm::Triple::mips || 464 llvm_arch == llvm::Triple::mipsel || 465 llvm_arch == llvm::Triple::mips64 || 466 llvm_arch == llvm::Triple::mips64el) 467 load_addr = GetCallableLoadAddress(target); 468 } 469 470 if (load_addr == LLDB_INVALID_ADDRESS) { 471 if (fallback_style != DumpStyleInvalid) 472 return Dump(s, exe_scope, fallback_style, DumpStyleInvalid, addr_size); 473 return false; 474 } 475 s->Address(load_addr, addr_size); 476 } break; 477 478 case DumpStyleResolvedDescription: 479 case DumpStyleResolvedDescriptionNoModule: 480 case DumpStyleResolvedDescriptionNoFunctionArguments: 481 case DumpStyleNoFunctionName: 482 if (IsSectionOffset()) { 483 uint32_t pointer_size = 4; 484 ModuleSP module_sp(GetModule()); 485 if (target) 486 pointer_size = target->GetArchitecture().GetAddressByteSize(); 487 else if (module_sp) 488 pointer_size = module_sp->GetArchitecture().GetAddressByteSize(); 489 490 bool showed_info = false; 491 if (section_sp) { 492 SectionType sect_type = section_sp->GetType(); 493 switch (sect_type) { 494 case eSectionTypeData: 495 if (module_sp) { 496 if (Symtab *symtab = module_sp->GetSymtab()) { 497 const addr_t file_Addr = GetFileAddress(); 498 Symbol *symbol = 499 symtab->FindSymbolContainingFileAddress(file_Addr); 500 if (symbol) { 501 const char *symbol_name = symbol->GetName().AsCString(); 502 if (symbol_name) { 503 s->PutCString(symbol_name); 504 addr_t delta = 505 file_Addr - symbol->GetAddressRef().GetFileAddress(); 506 if (delta) 507 s->Printf(" + %" PRIu64, delta); 508 showed_info = true; 509 } 510 } 511 } 512 } 513 break; 514 515 case eSectionTypeDataCString: 516 // Read the C string from memory and display it 517 showed_info = true; 518 ReadCStringFromMemory(exe_scope, *this, s); 519 break; 520 521 case eSectionTypeDataCStringPointers: 522 if (ReadAddress(exe_scope, *this, pointer_size, so_addr)) { 523 #if VERBOSE_OUTPUT 524 s->PutCString("(char *)"); 525 so_addr.Dump(s, exe_scope, DumpStyleLoadAddress, 526 DumpStyleFileAddress); 527 s->PutCString(": "); 528 #endif 529 showed_info = true; 530 ReadCStringFromMemory(exe_scope, so_addr, s); 531 } 532 break; 533 534 case eSectionTypeDataObjCMessageRefs: 535 if (ReadAddress(exe_scope, *this, pointer_size, so_addr)) { 536 if (target && so_addr.IsSectionOffset()) { 537 SymbolContext func_sc; 538 target->GetImages().ResolveSymbolContextForAddress( 539 so_addr, eSymbolContextEverything, func_sc); 540 if (func_sc.function != nullptr || func_sc.symbol != nullptr) { 541 showed_info = true; 542 #if VERBOSE_OUTPUT 543 s->PutCString("(objc_msgref *) -> { (func*)"); 544 so_addr.Dump(s, exe_scope, DumpStyleLoadAddress, 545 DumpStyleFileAddress); 546 #else 547 s->PutCString("{ "); 548 #endif 549 Address cstr_addr(*this); 550 cstr_addr.SetOffset(cstr_addr.GetOffset() + pointer_size); 551 func_sc.DumpStopContext(s, exe_scope, so_addr, true, true, 552 false, true, true); 553 if (ReadAddress(exe_scope, cstr_addr, pointer_size, so_addr)) { 554 #if VERBOSE_OUTPUT 555 s->PutCString("), (char *)"); 556 so_addr.Dump(s, exe_scope, DumpStyleLoadAddress, 557 DumpStyleFileAddress); 558 s->PutCString(" ("); 559 #else 560 s->PutCString(", "); 561 #endif 562 ReadCStringFromMemory(exe_scope, so_addr, s); 563 } 564 #if VERBOSE_OUTPUT 565 s->PutCString(") }"); 566 #else 567 s->PutCString(" }"); 568 #endif 569 } 570 } 571 } 572 break; 573 574 case eSectionTypeDataObjCCFStrings: { 575 Address cfstring_data_addr(*this); 576 cfstring_data_addr.SetOffset(cfstring_data_addr.GetOffset() + 577 (2 * pointer_size)); 578 if (ReadAddress(exe_scope, cfstring_data_addr, pointer_size, 579 so_addr)) { 580 #if VERBOSE_OUTPUT 581 s->PutCString("(CFString *) "); 582 cfstring_data_addr.Dump(s, exe_scope, DumpStyleLoadAddress, 583 DumpStyleFileAddress); 584 s->PutCString(" -> @"); 585 #else 586 s->PutChar('@'); 587 #endif 588 if (so_addr.Dump(s, exe_scope, DumpStyleResolvedDescription)) 589 showed_info = true; 590 } 591 } break; 592 593 case eSectionTypeData4: 594 // Read the 4 byte data and display it 595 showed_info = true; 596 s->PutCString("(uint32_t) "); 597 DumpUInt(exe_scope, *this, 4, s); 598 break; 599 600 case eSectionTypeData8: 601 // Read the 8 byte data and display it 602 showed_info = true; 603 s->PutCString("(uint64_t) "); 604 DumpUInt(exe_scope, *this, 8, s); 605 break; 606 607 case eSectionTypeData16: 608 // Read the 16 byte data and display it 609 showed_info = true; 610 s->PutCString("(uint128_t) "); 611 DumpUInt(exe_scope, *this, 16, s); 612 break; 613 614 case eSectionTypeDataPointers: 615 // Read the pointer data and display it 616 if (ReadAddress(exe_scope, *this, pointer_size, so_addr)) { 617 s->PutCString("(void *)"); 618 so_addr.Dump(s, exe_scope, DumpStyleLoadAddress, 619 DumpStyleFileAddress); 620 621 showed_info = true; 622 if (so_addr.IsSectionOffset()) { 623 SymbolContext pointer_sc; 624 if (target) { 625 target->GetImages().ResolveSymbolContextForAddress( 626 so_addr, eSymbolContextEverything, pointer_sc); 627 if (pointer_sc.function != nullptr || 628 pointer_sc.symbol != nullptr) { 629 s->PutCString(": "); 630 pointer_sc.DumpStopContext(s, exe_scope, so_addr, true, false, 631 false, true, true); 632 } 633 } 634 } 635 } 636 break; 637 638 default: 639 break; 640 } 641 } 642 643 if (!showed_info) { 644 if (module_sp) { 645 SymbolContext sc; 646 module_sp->ResolveSymbolContextForAddress( 647 *this, eSymbolContextEverything, sc); 648 if (sc.function || sc.symbol) { 649 bool show_stop_context = true; 650 const bool show_module = (style == DumpStyleResolvedDescription); 651 const bool show_fullpaths = false; 652 const bool show_inlined_frames = true; 653 const bool show_function_arguments = 654 (style != DumpStyleResolvedDescriptionNoFunctionArguments); 655 const bool show_function_name = (style != DumpStyleNoFunctionName); 656 if (sc.function == nullptr && sc.symbol != nullptr) { 657 // If we have just a symbol make sure it is in the right section 658 if (sc.symbol->ValueIsAddress()) { 659 if (sc.symbol->GetAddressRef().GetSection() != GetSection()) { 660 // don't show the module if the symbol is a trampoline symbol 661 show_stop_context = false; 662 } 663 } 664 } 665 if (show_stop_context) { 666 // We have a function or a symbol from the same sections as this 667 // address. 668 sc.DumpStopContext(s, exe_scope, *this, show_fullpaths, 669 show_module, show_inlined_frames, 670 show_function_arguments, show_function_name); 671 } else { 672 // We found a symbol but it was in a different section so it 673 // isn't the symbol we should be showing, just show the section 674 // name + offset 675 Dump(s, exe_scope, DumpStyleSectionNameOffset); 676 } 677 } 678 } 679 } 680 } else { 681 if (fallback_style != DumpStyleInvalid) 682 return Dump(s, exe_scope, fallback_style, DumpStyleInvalid, addr_size); 683 return false; 684 } 685 break; 686 687 case DumpStyleDetailedSymbolContext: 688 if (IsSectionOffset()) { 689 ModuleSP module_sp(GetModule()); 690 if (module_sp) { 691 SymbolContext sc; 692 module_sp->ResolveSymbolContextForAddress( 693 *this, eSymbolContextEverything | eSymbolContextVariable, sc); 694 if (sc.symbol) { 695 // If we have just a symbol make sure it is in the same section as 696 // our address. If it isn't, then we might have just found the last 697 // symbol that came before the address that we are looking up that 698 // has nothing to do with our address lookup. 699 if (sc.symbol->ValueIsAddress() && 700 sc.symbol->GetAddressRef().GetSection() != GetSection()) 701 sc.symbol = nullptr; 702 } 703 sc.GetDescription(s, eDescriptionLevelBrief, target); 704 705 if (sc.block) { 706 bool can_create = true; 707 bool get_parent_variables = true; 708 bool stop_if_block_is_inlined_function = false; 709 VariableList variable_list; 710 sc.block->AppendVariables(can_create, get_parent_variables, 711 stop_if_block_is_inlined_function, 712 [](Variable *) { return true; }, 713 &variable_list); 714 715 const size_t num_variables = variable_list.GetSize(); 716 for (size_t var_idx = 0; var_idx < num_variables; ++var_idx) { 717 Variable *var = variable_list.GetVariableAtIndex(var_idx).get(); 718 if (var && var->LocationIsValidForAddress(*this)) { 719 s->Indent(); 720 s->Printf(" Variable: id = {0x%8.8" PRIx64 "}, name = \"%s\"", 721 var->GetID(), var->GetName().GetCString()); 722 Type *type = var->GetType(); 723 if (type) 724 s->Printf(", type = \"%s\"", type->GetName().GetCString()); 725 else 726 s->PutCString(", type = <unknown>"); 727 s->PutCString(", location = "); 728 var->DumpLocationForAddress(s, *this); 729 s->PutCString(", decl = "); 730 var->GetDeclaration().DumpStopContext(s, false); 731 s->EOL(); 732 } 733 } 734 } 735 } 736 } else { 737 if (fallback_style != DumpStyleInvalid) 738 return Dump(s, exe_scope, fallback_style, DumpStyleInvalid, addr_size); 739 return false; 740 } 741 break; 742 743 case DumpStyleResolvedPointerDescription: { 744 Process *process = exe_ctx.GetProcessPtr(); 745 if (process) { 746 addr_t load_addr = GetLoadAddress(target); 747 if (load_addr != LLDB_INVALID_ADDRESS) { 748 Status memory_error; 749 addr_t dereferenced_load_addr = 750 process->ReadPointerFromMemory(load_addr, memory_error); 751 if (dereferenced_load_addr != LLDB_INVALID_ADDRESS) { 752 Address dereferenced_addr; 753 if (dereferenced_addr.SetLoadAddress(dereferenced_load_addr, 754 target)) { 755 StreamString strm; 756 if (dereferenced_addr.Dump(&strm, exe_scope, 757 DumpStyleResolvedDescription, 758 DumpStyleInvalid, addr_size)) { 759 s->Address(dereferenced_load_addr, addr_size, " -> ", " "); 760 s->Write(strm.GetString().data(), strm.GetSize()); 761 return true; 762 } 763 } 764 } 765 } 766 } 767 if (fallback_style != DumpStyleInvalid) 768 return Dump(s, exe_scope, fallback_style, DumpStyleInvalid, addr_size); 769 return false; 770 } break; 771 } 772 773 return true; 774 } 775 776 bool Address::SectionWasDeleted() const { 777 if (GetSection()) 778 return false; 779 return SectionWasDeletedPrivate(); 780 } 781 782 bool Address::SectionWasDeletedPrivate() const { 783 lldb::SectionWP empty_section_wp; 784 785 // If either call to "std::weak_ptr::owner_before(...) value returns true, 786 // this indicates that m_section_wp once contained (possibly still does) a 787 // reference to a valid shared pointer. This helps us know if we had a valid 788 // reference to a section which is now invalid because the module it was in 789 // was unloaded/deleted, or if the address doesn't have a valid reference to 790 // a section. 791 return empty_section_wp.owner_before(m_section_wp) || 792 m_section_wp.owner_before(empty_section_wp); 793 } 794 795 uint32_t 796 Address::CalculateSymbolContext(SymbolContext *sc, 797 SymbolContextItem resolve_scope) const { 798 sc->Clear(false); 799 // Absolute addresses don't have enough information to reconstruct even their 800 // target. 801 802 SectionSP section_sp(GetSection()); 803 if (section_sp) { 804 ModuleSP module_sp(section_sp->GetModule()); 805 if (module_sp) { 806 sc->module_sp = module_sp; 807 if (sc->module_sp) 808 return sc->module_sp->ResolveSymbolContextForAddress( 809 *this, resolve_scope, *sc); 810 } 811 } 812 return 0; 813 } 814 815 ModuleSP Address::CalculateSymbolContextModule() const { 816 SectionSP section_sp(GetSection()); 817 if (section_sp) 818 return section_sp->GetModule(); 819 return ModuleSP(); 820 } 821 822 CompileUnit *Address::CalculateSymbolContextCompileUnit() const { 823 SectionSP section_sp(GetSection()); 824 if (section_sp) { 825 SymbolContext sc; 826 sc.module_sp = section_sp->GetModule(); 827 if (sc.module_sp) { 828 sc.module_sp->ResolveSymbolContextForAddress(*this, 829 eSymbolContextCompUnit, sc); 830 return sc.comp_unit; 831 } 832 } 833 return nullptr; 834 } 835 836 Function *Address::CalculateSymbolContextFunction() const { 837 SectionSP section_sp(GetSection()); 838 if (section_sp) { 839 SymbolContext sc; 840 sc.module_sp = section_sp->GetModule(); 841 if (sc.module_sp) { 842 sc.module_sp->ResolveSymbolContextForAddress(*this, 843 eSymbolContextFunction, sc); 844 return sc.function; 845 } 846 } 847 return nullptr; 848 } 849 850 Block *Address::CalculateSymbolContextBlock() const { 851 SectionSP section_sp(GetSection()); 852 if (section_sp) { 853 SymbolContext sc; 854 sc.module_sp = section_sp->GetModule(); 855 if (sc.module_sp) { 856 sc.module_sp->ResolveSymbolContextForAddress(*this, eSymbolContextBlock, 857 sc); 858 return sc.block; 859 } 860 } 861 return nullptr; 862 } 863 864 Symbol *Address::CalculateSymbolContextSymbol() const { 865 SectionSP section_sp(GetSection()); 866 if (section_sp) { 867 SymbolContext sc; 868 sc.module_sp = section_sp->GetModule(); 869 if (sc.module_sp) { 870 sc.module_sp->ResolveSymbolContextForAddress(*this, eSymbolContextSymbol, 871 sc); 872 return sc.symbol; 873 } 874 } 875 return nullptr; 876 } 877 878 bool Address::CalculateSymbolContextLineEntry(LineEntry &line_entry) const { 879 SectionSP section_sp(GetSection()); 880 if (section_sp) { 881 SymbolContext sc; 882 sc.module_sp = section_sp->GetModule(); 883 if (sc.module_sp) { 884 sc.module_sp->ResolveSymbolContextForAddress(*this, 885 eSymbolContextLineEntry, sc); 886 if (sc.line_entry.IsValid()) { 887 line_entry = sc.line_entry; 888 return true; 889 } 890 } 891 } 892 line_entry.Clear(); 893 return false; 894 } 895 896 int Address::CompareFileAddress(const Address &a, const Address &b) { 897 addr_t a_file_addr = a.GetFileAddress(); 898 addr_t b_file_addr = b.GetFileAddress(); 899 if (a_file_addr < b_file_addr) 900 return -1; 901 if (a_file_addr > b_file_addr) 902 return +1; 903 return 0; 904 } 905 906 int Address::CompareLoadAddress(const Address &a, const Address &b, 907 Target *target) { 908 assert(target != nullptr); 909 addr_t a_load_addr = a.GetLoadAddress(target); 910 addr_t b_load_addr = b.GetLoadAddress(target); 911 if (a_load_addr < b_load_addr) 912 return -1; 913 if (a_load_addr > b_load_addr) 914 return +1; 915 return 0; 916 } 917 918 int Address::CompareModulePointerAndOffset(const Address &a, const Address &b) { 919 ModuleSP a_module_sp(a.GetModule()); 920 ModuleSP b_module_sp(b.GetModule()); 921 Module *a_module = a_module_sp.get(); 922 Module *b_module = b_module_sp.get(); 923 if (a_module < b_module) 924 return -1; 925 if (a_module > b_module) 926 return +1; 927 // Modules are the same, just compare the file address since they should be 928 // unique 929 addr_t a_file_addr = a.GetFileAddress(); 930 addr_t b_file_addr = b.GetFileAddress(); 931 if (a_file_addr < b_file_addr) 932 return -1; 933 if (a_file_addr > b_file_addr) 934 return +1; 935 return 0; 936 } 937 938 size_t Address::MemorySize() const { 939 // Noting special for the memory size of a single Address object, it is just 940 // the size of itself. 941 return sizeof(Address); 942 } 943 944 // NOTE: Be careful using this operator. It can correctly compare two 945 // addresses from the same Module correctly. It can't compare two addresses 946 // from different modules in any meaningful way, but it will compare the module 947 // pointers. 948 // 949 // To sum things up: 950 // - works great for addresses within the same module - it works for addresses 951 // across multiple modules, but don't expect the 952 // address results to make much sense 953 // 954 // This basically lets Address objects be used in ordered collection classes. 955 956 bool lldb_private::operator<(const Address &lhs, const Address &rhs) { 957 ModuleSP lhs_module_sp(lhs.GetModule()); 958 ModuleSP rhs_module_sp(rhs.GetModule()); 959 Module *lhs_module = lhs_module_sp.get(); 960 Module *rhs_module = rhs_module_sp.get(); 961 if (lhs_module == rhs_module) { 962 // Addresses are in the same module, just compare the file addresses 963 return lhs.GetFileAddress() < rhs.GetFileAddress(); 964 } else { 965 // The addresses are from different modules, just use the module pointer 966 // value to get consistent ordering 967 return lhs_module < rhs_module; 968 } 969 } 970 971 bool lldb_private::operator>(const Address &lhs, const Address &rhs) { 972 ModuleSP lhs_module_sp(lhs.GetModule()); 973 ModuleSP rhs_module_sp(rhs.GetModule()); 974 Module *lhs_module = lhs_module_sp.get(); 975 Module *rhs_module = rhs_module_sp.get(); 976 if (lhs_module == rhs_module) { 977 // Addresses are in the same module, just compare the file addresses 978 return lhs.GetFileAddress() > rhs.GetFileAddress(); 979 } else { 980 // The addresses are from different modules, just use the module pointer 981 // value to get consistent ordering 982 return lhs_module > rhs_module; 983 } 984 } 985 986 // The operator == checks for exact equality only (same section, same offset) 987 bool lldb_private::operator==(const Address &a, const Address &rhs) { 988 return a.GetOffset() == rhs.GetOffset() && a.GetSection() == rhs.GetSection(); 989 } 990 991 // The operator != checks for exact inequality only (differing section, or 992 // different offset) 993 bool lldb_private::operator!=(const Address &a, const Address &rhs) { 994 return a.GetOffset() != rhs.GetOffset() || a.GetSection() != rhs.GetSection(); 995 } 996 997 AddressClass Address::GetAddressClass() const { 998 ModuleSP module_sp(GetModule()); 999 if (module_sp) { 1000 ObjectFile *obj_file = module_sp->GetObjectFile(); 1001 if (obj_file) { 1002 // Give the symbol file a chance to add to the unified section list 1003 // and to the symtab. 1004 module_sp->GetSymtab(); 1005 return obj_file->GetAddressClass(GetFileAddress()); 1006 } 1007 } 1008 return AddressClass::eUnknown; 1009 } 1010 1011 bool Address::SetLoadAddress(lldb::addr_t load_addr, Target *target, 1012 bool allow_section_end) { 1013 if (target && target->GetSectionLoadList().ResolveLoadAddress( 1014 load_addr, *this, allow_section_end)) 1015 return true; 1016 m_section_wp.reset(); 1017 m_offset = load_addr; 1018 return false; 1019 } 1020